Coda MCP server for AI agents

This MCP server implements the Model Context Protocol to bridge communication with the Coda API, enabling AI assistants to interact with Coda documents and pages directly. It provides various tools for managing Coda content through an MCP interface.

Installation Options

Using NPX (Recommended)

The simplest way to use the Coda MCP server is through NPX. Add it to your MCP-compatible application (such as Cursor or Claude Desktop) by configuring it as follows:

{
  "mcpServers": {
    "coda": {
      "command": "npx",
      "args": ["-y", "coda-mcp@latest"],
      "env": {
        "API_KEY": "your-coda-api-key-here"
      }
    }
  }
}

Using Docker

Alternatively, you can run the server using Docker:

{
  "mcpServers": {
    "coda": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "API_KEY", "reaperberri/coda-mcp:latest"],
      "env": {
        "API_KEY": "your-coda-api-key-here"
      }
    }
  }
}

Manual Installation

If you prefer to install and run the server locally:

Install Node.js and pnpm
Install the package:

pnpm install coda-mcp

Run the server with your API key:

API_KEY=your-coda-api-key-here node node_modules/coda-mcp/dist/index.js

Configuration

The server requires the following environment variable:

API_KEY: Your Coda API key, which can be generated from your Coda account settings

Available Tools

The Coda MCP server provides the following tools:

Document Management

coda_list_documents: Lists all documents available to the authenticated user

Page Management

coda_list_pages: Lists all pages within a Coda document with pagination support
coda_create_page: Creates a new page in the document
- Can create subpages under a parent page
- Supports populating with initial markdown content
coda_duplicate_page: Creates a copy of an existing page with a new name
coda_rename_page: Renames an existing page

Content Management

coda_get_page_content: Retrieves page content as markdown (specify by ID or name)
coda_replace_page_content: Replaces a page's content with new markdown
coda_append_page_content: Adds new markdown content to the end of a page
coda_peek_page: Returns the first few lines of a page

Usage Examples

Listing Documents

To list all available Coda documents:

const documents = await coda_list_documents();
console.log(documents);

Creating a Page

To create a new page with content:

const newPage = await coda_create_page({
  name: "My New Page",
  content: "# Welcome\n\nThis is a new page created via MCP.",
  parentPageId: "optional-parent-id" // Optional
});

Reading Page Content

To retrieve the content of a page:

const content = await coda_get_page_content({
  pageId: "page-id-here" // Or use pageName instead
});

Updating Page Content

To replace a page's content:

await coda_replace_page_content({
  pageId: "page-id-here",
  content: "# Updated Content\n\nThis is the new page content."
});

To append content to a page:

await coda_append_page_content({
  pageId: "page-id-here",
  content: "\n\n## New Section\nThis content will be added to the end."
});

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "coda" '{"command":"npx","args":["-y","coda-mcp@latest"],"env":{"API_KEY":"..."}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "coda": {
            "command": "npx",
            "args": [
                "-y",
                "coda-mcp@latest"
            ],
            "env": {
                "API_KEY": "..."
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "coda": {
            "command": "npx",
            "args": [
                "-y",
                "coda-mcp@latest"
            ],
            "env": {
                "API_KEY": "..."
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect