# mcp-coda

> MCP server for the Coda API. It provides 54 tools, 12 resources, and 5 prompts for docs, pages, tables, rows, formulas, controls, permissions, folders, publishing, automations, and analytics.

mcp-coda is an MCP server that wraps the Coda REST API v1. It gives an AI assistant CRUD access to all Coda resource types, live and static context, and prompt templates for common workflows. It implements the MCP 2026-07-28 specification (MCP 2.0) and stays compatible with 2025-11-25 clients. It uses FastMCP 4.x, httpx, and Pydantic.

- **Install**: `uvx mcp-coda`
- **Version**: 0.9.0
- **Python**: >=3.10
- **License**: MIT
- **MCP protocol**: 2026-07-28 (MCP 2.0); compatible with 2025-11-25 clients
- **Transport**: stdio (default), streamable-http (recommended for remote); sse (deprecated by MCP 2026-07-28, still works)
- **Registry**: `io.github.vish288/mcp-coda`
- **Required env vars**: `CODA_API_TOKEN` (also accepts `CODA_TOKEN` or `CODA_PAT`)
- **Optional env vars**: `CODA_READ_ONLY` (disable writes), `CODA_BASE_URL` (API base), `CODA_TIMEOUT` (request timeout), `CODA_HTTP_BEARER_TOKEN` (required to bind an HTTP transport to a non-loopback host; min 16 chars)

## Documentation

- [README](https://github.com/vish288/mcp-coda#readme): canonical reference for setup, env vars, all 54 tools, 12 resources, 5 prompts
- [PyPI](https://pypi.org/project/mcp-coda/): install via `pip install mcp-coda` or `uvx mcp-coda`
- [GitHub](https://github.com/vish288/mcp-coda): source code, issue tracker, development setup
- [MCP Registry](https://registry.modelcontextprotocol.io): discover and install MCP servers

## Optional

- [Changelog](https://github.com/vish288/mcp-coda/releases): per-version release notes with breaking changes
- [MCP Specification](https://modelcontextprotocol.io/docs): protocol spec for tools, resources, and prompts
- [FastMCP](https://github.com/jlowin/fastmcp): Python framework this server is built on
- [Coda API Reference](https://coda.io/developers/apis/v1): upstream REST API that this server wraps
