该项目实现了一个模型上下文协议（MCP）服务器，作为与 Coda API 交互的桥梁。它允许 MCP 客户端（类似 AI 助手）对 Coda 页面执行操作，如列出、创建、阅读、更新、复制和重命名。

[!注] 这个MCP服务器并非由Coda开发或维护;这是一个社区构建的项目。

特色

服务器向MCP客户端暴露以下工具：

• coda_list_documents：列出所有用户可用的文档。
• coda_list_pages：列出配置好的 Coda 文档中支持分页的所有页面。
• coda_create_page：在文档中创建一个新页面，可选地在指定的父页面下创建（创建子页面），并填充初始的 markdown 内容。
• coda_get_page_content：通过ID或名称获取指定页面的内容，作为markdown。
• coda_replace_page_content：用新的 markdown 内容替换指定页面的内容。
• coda_append_page_content：在指定页面末尾附加新的降码内容。
• coda_duplicate_page：创建已有页面并带有新名称的副本。

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 Coda pages, such as listing, creating, reading, updating, duplicating, and renaming.

[!NOTE]
This MCP server is not developed or maintained by Coda; it’s a community-built project.

Features

The server exposes the following tools to the MCP client:

• 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 (creating a subpage) and populating it with initial markdown content.
• coda_get_page_content: Retrieves the content of a specified page (by ID or name) 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: Peek into the beginning of a page and return a limited number of lines.
• coda_resolve_link: Resolve metadata given a browser link to a Coda object.
• coda_list_tables: List tables in a document.
• coda_list_columns: List columns in a table.
• coda_list_rows: List rows in a table with optional filtering and sorting.
• coda_get_row: Get a single row from a table.
• coda_upsert_rows: Insert or upsert rows into a table.
• coda_update_row: Update a single row in a table.
• coda_delete_row: Delete a single row from a table.
• coda_delete_rows: Delete multiple rows from a table.
• coda_push_button: Push a button column on a row in a table.

Usage

Add the MCP server to Cursor/Claude Desktop/etc. like so:

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

Required environment variables:

• API_KEY: Your Coda API key. You can generate one from your Coda account settings.

This MCP server is also available with Docker, like so:

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

Local Setup

1. Prerequisites:

   • Node.js
   • pnpm

2. Clone the repository:

   git clone 
   cd coda-mcp
   

3. Install dependencies:

   pnpm install
   

4. Build the project:

   pnpm build