MCP 服务器

Coda MCP Server

A Model Context Protocol server that enables AI assistants to interact with Coda documents, allowing operations like listing, creating, reading, updating, and duplicating pages.

Tools

update-page

Replace or append to the content of a page

list-pages

List pages in the current document

create-page

Create a page in the current document

get-page-content

Get the content of a page as markdown

duplicate-page

Duplicate a page in the current document

README

Coda MCP Server

This project implements a Model Context Protocol (MCP) server that acts as a bridge to interact with the Coda API. It allows an MCP client (like an AI assistant) to perform actions on a specific Coda document, such as listing, creating, reading, updating, and duplicating pages.

Features

The server exposes the following tools to the MCP client:

list-pages: Lists all pages within the configured Coda document.
create-page: Creates a new page in the document, optionally populating it with initial markdown content.
get-page-content: Retrieves the content of a specified page (by ID or name) as markdown.
update-page: Replaces or appends markdown content to a specified page.
duplicate-page: Creates a copy of an existing page with a new name.

Usage

Add the MCP server to Cursor/Claude Desktop/etc. with the following execution command:

npx coda-mcp@latest

For example, in Cursor/Claude Desktop, you can add it like so:

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

Required environment variables:

API_KEY: Your Coda API key. You can generate one from your Coda account settings.
DOC_ID: The ID of the Coda document you want the server to interact with. You can find this in the document's URL (the part after d).

Local Setup

Prerequisites:
- Node.js
- pnpm
Clone the repository:
```
git clone <repository-url>
cd coda-mcp
```
Install dependencies:
```
pnpm install
```
Build the project:
```
pnpm build
```
This compiles the TypeScript code to JavaScript in the dist/ directory.

Running the Server

The MCP server communicates over standard input/output (stdio). To run it, set the environment variables and run the compiled JavaScript file - dist/index.js.