home / mcp / coda mcp server

Coda MCP Server

MCP Server for Coda

Installation

Add the following to your MCP client configuration file.

Configuration

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

The Coda MCP Server acts as a bridge between an MCP client and the Coda API, enabling you to list, read, create, update, rename, and manage pages within your Coda documents through simple MCP actions.

How to use

You use this server by starting it in your MCP-enabled client environment and connecting to it as an MCP source. The server exposes a set of actions that let your assistant list documents, enumerate pages, read and modify page content, duplicate or rename pages, and resolve page metadata from links. You can combine these actions to automate document workflows, content generation, and page organization without leaving your chat or automation context.

How to install

Prerequisites: you need Node.js and pnpm installed on your system.

Step by step setup flow you can follow to run the MCP server locally.

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

Additional setup options

If you prefer running the server inside a container, you can use Docker with the same API key configuration. The following example shows how to run the MCP server in Docker and pass the API key through the environment.

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

Notes on prerequisites and startup

The server runs over standard input/output (stdio). After you configure one of the available startup methods, start the compiled server accordingly so your MCP client can communicate with it.

Security and environment

Protect your API key and ensure it is provided to the server in a secure manner. Use environment variable injection in your deployment to avoid embedding secrets in code or configuration files.

Troubleshooting

If you encounter connection issues, verify that the API key is valid, the MCP client is configured to target the running server, and the environment variables are accessible to the process running the MCP server.

Available tools

coda_list_documents

Lists all documents available to the user.

coda_list_pages

Lists all pages within the configured Coda document with pagination support.

coda_create_page

Creates a new page in the document, optionally under a specified parent page and populates it with initial markdown content.

coda_get_page_content

Retrieves the content of a specified page as markdown.

coda_replace_page_content

Replaces the content of a specified page with new markdown content.

coda_append_page_content

Appends new markdown content to the end of a specified page.

coda_duplicate_page

Creates a copy of an existing page with a new name.

coda_rename_page

Renames an existing page.

coda_peek_page

Peeks into the beginning of a page and returns a limited number of lines.

coda_resolve_link

Resolves metadata given a browser link to a Coda object.