このプロジェクトでは、モデルコンテキストプロトコル(MCP)サーバーを実装し、Coda APIとやり取りするブリッジとして機能します。 MCP クライアント (AI アシスタントのような) は、リスト、作成、読み込み、更新、duplicating、および名前変更などのコダページ上のアクションを実行できます。

[!NOTE] このMCPサーバは、コダが開発・維持するものではありません。

##特徴

サーバは、次のツールを MCP クライアントに公開します。

-[coda_list_documents: ユーザーが利用できるすべての文書をリストします。 -[coda_list_pages: 設定されたコダ文書内のすべてのページをペジネーションサポートでリストします。 -[coda_create_page: 指定された親ページ(サブページを作成する)の下に、必要に応じて、ドキュメント内の新しいページを作成し、初期のマークダウンコンテンツでポップアップします。 -[coda_get_page_content: 指定したページの内容をマークダウンとして取得します。 -[coda_replace_page_content: 指定したページの内容を新しいマークダウンコンテンツに置き換えます。 -[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