Coda MCP Server

1# Coda MCP Server
2 
3This project implements a Model Context Protocol (MCP) server that acts as a bridge to interact with the [Coda](https://coda.io/) 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.
4 
5## Features
6 
7The server exposes the following tools to the MCP client:
8 
9- **`coda_list_documents`**: Lists all documents available to the user.
10- **`coda_list_pages`**: Lists all pages within the configured Coda document with pagination support.
11- **`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.
12- **`coda_get_page_content`**: Retrieves the content of a specified page (by ID or name) as markdown.
13- **`coda_replace_page_content`**: Replaces the content of a specified page with new markdown content.
14- **`coda_append_page_content`**: Appends new markdown content to the end of a specified page.
15- **`coda_duplicate_page`**: Creates a copy of an existing page with a new name.
16- **`coda_rename_page`**: Renames an existing page.
17- **`coda_peek_page`**: Peek into the beginning of a page and return a limited number of lines.
18- **`coda_resolve_link`**: Resolve metadata given a browser link to a Coda object.
19 
20## Usage
21 
22Add the MCP server to Cursor/Claude Desktop/etc. like so:
23 
24```json
25{
26  "mcpServers": {
27    "coda": {
28      "command": "npx",
29      "args": ["-y", "coda-mcp@latest"],
30      "env": {
31        "API_KEY": "..."
32      }
33    }
34  }
35}
36```
37 
38Required environment variables:
39 
40- `API_KEY`: Your Coda API key. You can generate one from your Coda account settings.
41 
42This MCP server is also available with Docker, like so:
43 
44```json
45{
46  "mcpServers": {
47    "coda": {
48      "command": "docker",
49      "args": ["run", "-i", "--rm", "-e", "API_KEY", "reaperberri/coda-mcp:latest"],
50      "env": {
51        "API_KEY": "..."
52      }
53    }
54  }
55}
56```
57 
58## Local Setup
59 
601.  **Prerequisites:**
61 
62    - Node.js
63    - pnpm
64 
652.  **Clone the repository:**
66 
67    ```bash
68    git clone <repository-url>
69    cd coda-mcp
70    ```
71 
723.  **Install dependencies:**
73 
74    ```bash
75    pnpm install
76    ```
77 
784.  **Build the project:**
79    ```bash
80    pnpm build
81    ```
82    This compiles the TypeScript code to JavaScript in the `dist/` directory.
83 
84## Running the Server
85 
86The MCP server communicates over standard input/output (stdio). To run it, set the environment variables and run the compiled JavaScript file - `dist/index.js`.
87