{"article":{"id":44722661982989,"url":"https://coda-docs.zendesk.com/api/v2/help_center/en-us/articles/44722661982989.json","html_url":"https://help.coda.io/hc/en-us/articles/44722661982989-Connect-to-the-Coda-MCP","author_id":35474998085645,"comments_disabled":true,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":39559727789837,"created_at":"2026-03-31T02:59:56Z","updated_at":"2026-06-05T19:16:54Z","name":"Connect to the Coda MCP","title":"Connect to the Coda MCP","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-06-05T19:16:54Z","user_segment_id":null,"permission_group_id":1715972,"content_tag_ids":[],"label_names":[],"body":"
The Coda MCP (Model Context Protocol) is a connection layer that enables AI clients - like Cursor, Claude, etc. - to read and write to your Coda docs using plain-language prompts. Instead of clicking through the Coda UI, you describe what you want in the chat window of your chosen client, and the AI carries it out directly in your doc. Think of it as giving an AI agent the same access to your Coda workspace that you have, and letting it act on your behalf based on your instructions.
 
The following article will walk you through the steps of connecting your preferred AI tool to the Coda MCP. Once you’ve connected, you can check out this article for some helpful guidance and examples on using the Coda MCP.

ℹ️ The Coda MCP is in beta. Behavior and available tools are subject to change.

\n
Within this article, you’ll find...\n

 

Supported clients

The table below lists the clients for which Coda MCP is currently well supported. We've also included the method of authentication available for each client. To learn more about these different authentication methods, refer to this article.
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Supported clientMethod of authentication
ChatGPTOAuth 2
\nClaude (including Claude Code, Claude Cowork, and Claude Chat)OAuth 2
CoPilot StudioPersonal Access Tokens
CursorOAuth 2
OpenAI CodexPersonal Access Tokens
Google AntigravityPersonal Access Tokens
You can find specific instructions for connecting to each of these clients in the subsequent sections.
 
\n
 

Connect ChatGPT with Coda MCP

Follow the steps below to connect ChatGPT with Coda MCP:
    \n
  1. Within ChatGPT, click into the Apps tab of the left panel
    2. \n
  2. Enter \"Coda\" in the search bar
    3. \n
  3. Select Coda from the search results, then click Connect
    1. \nNote: If you see Disabled by admin instead of Connect, this likely indicates that the admin of your account has disabled connecting to new apps. We suggest contacting your admin and requesting they enable the Coda app for you or your org. Refer to this documentation to learn more.\n
    \n
    4. \n
  4. Click Sign in with Coda
    \"Update\n
    5. \n
  5. A new tab will open, where you will be prompted to sign into Coda and grant ChatGPT the necessary access.
    6. \n
  6. Once authentication has been completed, you'll be redirected back to ChatGTP and should see a Coda is now connected confirmation.
    7. \n
You should now be successfully connected to the Coda MCP and can start using it within your chats.
 
\n

Tip: If you would like to give ChatGPT more context when working with Coda, look for the Reference memories and chats setting during the connection process (right below the Sign in with Coda button). This setting is toggled off by default, but you can toggle it on if desired. And if you've already connected to Coda and want to change this setting retroactively, just click on your account name in the lower-left > Settings > Apps > Coda app > toggle on/off the Reference memories and chats option.

\n
\"16_9
\n
 
 
 

Connect Claude Chat & Cowork with Coda MCP

Whether you use Claude Chat or Claude Cowork, this section will help you connect Claude to the Coda MCP.
\n

ℹ️ Before you begin: If you are using Claude Desktop for either Chat or Cowork, you must have Node.js v20.18.1 or higher installed on your device in order to complete the connection to Coda MCP.

\n\n
Node.js is not a requirement if accessing Claude Chat via web browser.
\n
 
To connect Claude Chat or Cowork to the Coda MCP:
    \n
  1. Open Claude
    2. \n
  2. In the lower-left corner, click on your account name, then select Settings\n
    3. \n
  3. Click into the Connectors section
    4. \n
  4. If you're part of a Team or Enterprise plan on Claude, and your admin has configured Coda MCP as a connector, you may see Coda already in the list of connectors (see FAQ at the bottom of this article to learn more). If so, simply click the corresponding Connect button and follow the prompts to authenticate your account. If you do not see Coda already in the list of connectors, then jump to the next step to learn about adding custom connectors.
    5. \n
  5. Scroll to the bottom of the list of connectors, and select Add custom connectors
    1. \n

      Note that if an enterprise manages your Claude account, your administrators may have limited the ability to add custom connectors. In these cases, this button will be greyed out, and you will see this message: “Contact an organization owner to add custom connectors.” Before you can move forward, your admin will either need to 1) modify your permissions or 2) pre-configure Coda MCP for your org (see FAQ below) so that it shows up in the connector list.

      \n
      \"16_9
      \n
    \n
    6. \n
  6. Give your connector a name, then enter the following URL into the Remote MCP Server URL field: https://coda.io/apis/mcp\n
    7. \n
  7. Click Add\n
    8. \n
  8. Now find the newly added connector in the list, and click Connect\n
    9. \n
  9. Follow the prompts to allow Claude access to Coda
    10. \n
  10. Once authorized, you’re all set. You can start taking actions in Coda with Claude!
    11. \n
\"16_9

ℹ️ To learn more about adding custom connectors to Claude, refer to their documentation here.

 

Resolve Node issues when connecting to Claude desktop

Download the latest version of Node.js
\n

Claude Desktop requires a tool called Node.js to run the Coda MCP connection. To install the latest version of Node, follow these steps:

\n
    \n
  1. Hit Cmd+Space → Terminal to open Terminal.
    2. \n
  2. In Terminal, type or paste the following command:
    3. \n
\n
/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"
\n
    \n
  1. Hit Enter.
    2. \n
  2. Terminal will ask for your Mac login password. When you type it, nothing will appear on screen — no dots, no asterisks, nothing. This is completely normal! Just type your password carefully and hit Enter.
    3. \n
  3. The installation may take a few minutes. Make sure to pay attention to Homebrew's instructions for next steps. You'll likely need to run three individual commands in your terminal to add Homebrew to your PATH — two start with echo and one starts with eval.
    4. \n
  4. Wait until you see the regular prompt again (ending with % or $). Then install Node.js by pasting the following command:
    5. \n
\n
brew install node
\n
    \n
  1. Hit Enter.
    2. \n
  2. Verify everything is installed correctly by pasting the following command:
    3. \n
\n
npx --version
\n
    \n
  1. Hit Enter.
    2. \n
  2. If you see a version number (like 10.8.2), you're good to move on. If it says command not found, try closing and reopening Terminal, then run npx --version again.
    3. \n
\n
If Node is installed but you’re still running into errors...
\n

For instance, you might be seeing \"File is not defined,\" \"Cannot find module 'node:path,'\" or \"Unsupported engine\" errors when connecting the Coda MCP on Claude Desktop. This can happen if you have multiple Node.js versions installed and your system is defaulting to the wrong one. To resolve this, follow the steps below:

\n

Step 1: Find your Node 20 path

\n
    \n
  1. Hit Cmd+Space → Terminal to open Terminal.
    2. \n
  2. In Terminal, type or paste the following command:
    3. \n
\n
nvm which 20
\n
  1. Hit Enter.
\n

This should print a path like /Users/yourname/.nvm/versions/node/v20.x.x/bin/node. Copy everything up to and including /bin/ — you'll need it in the next step.

\n

If this command says N/A or fails, install Node 20 first:

\n
nvm install 20
\n

Then run nvm which 20 again.

\n

 

\n

Step 2: Connect to the Coda MCP via the Claude UI

\n
  1. Follow the steps in the \"Connect Claude Chat & Cowork to Coda MCP\" section of this article.
     
\n

Step 3: Clear the npm cache

\n
    \n
  1. Hit Cmd+Space → Terminal to open Terminal.
    2. \n
  2. In Terminal, type or paste the following command:
    3. \n
\n
rm -rf ~/.npm/_npx
\n
  1. Hit Enter.
     
\n

Step 4: Restart Claude Desktop

\n
    \n
  1. Fully quit and reopen Claude Desktop.
    2. \n
  2. The MCP Server should now connect successfully.
     
    3. \n
\n

Windows users: The steps are the same, with a few differences:

\n\n

 

 
 

Connect Claude Code with Coda MCP

To connect Claude Code to the Coda MCP, follow these steps:
  1. To start, open a fresh terminal window and run the following block:
claude mcp add --transport http Coda https://coda.io/apis/mcp
    \n
  1. Once the above has run, type Claude into your terminal and hit Enter\n
    2. \n
  2. Then type /mcp into the terminal and hit Enter again.
    3. \n
  3. You should now see a notice that Coda MCP needs authentication. Click Enter and select Authenticate.
    4. \n
  4. This will open a browser window where you'll be asked to allow Claude Code access to Coda. You'll also see that the redirect URL is localhost, which is expected based on how Claude handles OAuth. Follow the prompts to accept and proceed. You should then see an Authentication Successful confirmation.
    5. \n
  5. To confirm connection to the Coda MCP, return to your terminal window and enter the following:
    6. \n
Are you connected to the Coda MCP?
 

If successful, you’ll see a success message with Coda MCP tools. You can now start building in Coda using Claude Code!

\"16_10
\n

ℹ️ Troubleshooting & Tips:

\n\n
Find more details in Claude’s MCP documentation.
\n
 
 
 

Connect Copilot Studio with Coda MCP

To connect Copilot Studio with the Coda MCP, you will need to authenticate via Personal Access Tokens from your Coda account. Follow the steps below to learn more:

    \n
  1. \n

    First, you’ll need to generate a personal access token from your Coda account page. You can click here (or scroll to the API settings section of your account page, then click Generate API token). Give your token a memorable name, ensure that the restriction type is MCP, and choose the type of access. Then click the Generate API token button to create. Once created, click the Copy token button to copy it to your clipboard.

    \n
    \"generate
    \n
    2. \n
  2. Next, within Copilot Studio, open the agent you want to connect to the MCP.
    3. \n
  3. From the menu across the top of the agent page, select Tools, then click the + Add a tool button.
    4. \n
  4. Within the Create new options, select Model Context Protocol.
    5. \n
  5. Enter the following info:
      \n
    1. \nServer name and Server Description: fill these in as you see fit (for instance \"Coda MCP\" and \"Coda MCP to read and write to docs\"
      2. \n
    2. \nServer URL: https://coda.io/apis/mcp\n
      3. \n
    3. \nAuthorization: Select the API Key option. Then for the Type choose Header, and for the Header name enter Authorization\n
      4. \n
    \n
    6. \n
  6. Once all the above info has been entered, hit Create.
    7. \n
  7. You'll then see the newly added tool, but you'll notice it's not yet connected. Click on Not connected and select Create new connection.
    8. \n
  8. In the hidden field, enter the following string: Bearer Your-Coda-Auth-Token - making sure to replace Your-Coda-Auth-Token with the token you generated in step 1.
    1. For instance, Bearer 1bxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\n
    \n
    9. \n
  9. Hit Create button to finalize the connection.
    10. \n

 

 

Connect Cursor with Coda MCP

To connect Cursor with Coda MCP, follow these steps:
    \n
  1. Within your Cursor app, simply open up Cursor Settings and select the Tools & MCP section.
    2. \n
  2. Then click New MCP Server. This will open a new mcp.json file.
    1. Tip: Only enable the MCPs you are currently working with to save context and improve agent accuracy
    \n
    3. \n
  3. Inside your mcp.json file in Cursor, insert the following code:
    4. \n
{  
   \"mcpServers\": {    
      \"Coda\": {
        \"url\": \"https://coda.io/apis/mcp\"
    }
  }
}
  1. \n

    Once you’ve made the above edits, the file should be saved automatically, and you should now be connected to the Coda MCP. You can verify by checking the tools list (under Tools & MCP) or asking Cursor about your tools in Coda. 

    \n
    \"1_1
    1. Tip: If you don’t see your MCP show up at this stage, restart Cursor.
    \n
You can now use the Cursor agent to put the Coda MCP to work 🚀
 

ℹ️ To learn more about connecting MCPs in Cursor, please refer to Cursor’s documentation.

 
 
 

Connect OpenAI Codex CLI with Coda MCP

To connect OpenAI Codex with Coda MCP, you will need to use Personal Access Tokens from your Coda Account page. Follow the steps below to learn more.
 
To connect Codex CLI with Coda MCP, follow these steps:
    \n
  1. \n

    First, you’ll need to generate an auth token from your Coda account page. You can click here (or scroll to the API settings section of your account page, then click Generate API token). Give your token a memorable name, ensure that the restriction type is MCP, and choose the type of access. Then click the Generate API token button to create. Once created, click the Copy token button to copy it to your clipboard.

    \n
    \"generate
    \n
    2. \n
  2. Open a fresh terminal window and paste the block below into it, making sure to replace the Your-Coda-Auth-Token section with the auth token you generated and copied in the previous step.
    3. \n
codex mcp add Coda -- npx -y mcp-remote https://coda.io/apis/mcp --header \"Authorization: Bearer Your-Coda-Auth-Token\"
  1. Start Codex by typing codex into your terminal. You should be all set and can start using the Coda MCP!
     

ℹ️ For more details on connecting MCPs to OpenAI Codex, we suggest checking out their first-party documentation.

 
 
 

Connect Google Antigravity with Coda MCP

To connect Google Antigravity with Coda MCP, you will need to use Personal Access Tokens from your Coda Account page. Follow the steps below to learn more.
 
Follow these steps to connect Google Antigravity with Coda MCP:
    \n
  1. \n

    First, you’ll need to generate an auth token from your Coda account page. You can click here (or scroll to the API settings section of your account page, then click Generate API token). Give your token a memorable name, ensure that the restriction type is MCP, and choose the type of access. Then click the Generate API token button to create. Once created, click the Copy token button to copy it to your clipboard.

    \n
    \"generate
    \n
    2. \n
  2. \n

    Open Google Antigravity. Within the agent panel, click on the horizontal three-dot menu in the upper-right corner, and select MCP Servers. Then click Manage MCP Servers. 

    \n
    \"1_1
    \n
    3. \n
  3. Now click the View raw config option at the top of the page and enter the following details - making sure to replace the Your-Coda-MCP-Auth-Token section with the auth token you generated and copied in the previous step.
    4. \n
{
  \"mcpServers\": {
    \"Coda\": {
      \"serverUrl\": \"https://coda.io/apis/mcp\",
      \"headers\": {
        \"Authorization\": \"Bearer Your-Coda-MCP-Auth-Token\"
      }
    }
  }
}
  1. \n
    Save your settings, and hit refresh in Antigravity (if it doesn’t automatically refresh on its own). Coda should now appear as an available MCP tool in Antigravity.
    \n
    \"Screenshot

     

    \n

ℹ️ For more details on connecting MCPs to Google Antigravity, please refer to their documentation.

 
 
 

FAQs

Can I connect Coda MCP to other AI tools not listed in this article?
\n

You should be able to connect the Coda MCP to any AI client that supports creating custom MCP connections. In most cases, you will need to use Personal Access Tokens to complete the connection.

\n
To acquire these access tokens from Coda, you can click here (or scroll to the API settings section of your account page, then click Generate API token). Give your token a memorable name, ensure that the restriction type is MCP, and choose the type of access. Then click the Generate API token button to create. Once created, click the Copy token button to copy it to your clipboard.
\n
Do I have to be a Doc Maker to connect to the Coda MCP?
\n

No - you do not have to be a Doc Maker to connect to the Coda MCP. Anyone can connect to the Coda MCP, but what you can do from there does depend on your role in Coda.

\n
\nDoc Makers on paid Coda plans will have access to the full Coda MCP experience, including all of the available tools and endpoints.
\n
 
\n
Doc Makers on free plans can utilize a “free taste” of the Coda MCP (30 requests per week, with a max of 60 requests per month). During this “free taste,” you can utilize all of the tools of the MCP.
\n
 
\n
Editors also have access to a “free taste” of the Coda MCP (30 requests per week, with a max of 60 requests per month). However, they are limited to only the “read” type tools and actions. In other words, editors will not be able to use the MCP to update or add content, or to take other Doc Maker actions.
\n
 
\n
Can I configure Coda MCP as a custom connector in Claude, so the rest of my organization can easily connect? 
\n

Yes - if you are on a Team or Enterprise plan in Claude, an Owner or Primary Owner can configure Coda MCP as a custom connector on behalf of your org. Once this is done, organization members can easily find the Coda MCP in their available connectors and will be able to connect in a few short clicks.

\n

To complete this configuration on behalf of your organization, follow these steps:

\n
    \n

  1. Ensure you're logged into Claude as an Owner or Primary Owner

    2. \n

  2. Open Organization settings

    3. \n

  3. Click into the Connectors tab

    4. \n

  4. In the upper-right, click the Add button, hover over the Custom option, then select Web

    5. \n

  5. Next, enter the following URL in the appropriate field: https://coda.io/apis/mcp

    6. \n

  6. Finally, click Add

    7. \n
\n

Now, when members of your org navigate to the Connectors section of their Claude settings, they will see Coda as an available connector (with a custom label). They'll just need to click the Connect button, then follow the prompts to authenticate.

\n

Read more about configuring and connecting to custom connectors in Claude here.

\n
Why am I getting a 401 error when trying to use my auth token to connect?

You may see this error when the auth token has the incorrect restriction type. To resolve this, we suggest creating a new auth token via your Coda account settings, this time ensuring that you select MCP for the restriction type. Then attempt the connection again using this new token.

What auth scopes are used when connecting to the Coda MCP?
\n

When connecting the Coda MCP via OAuth 2 (as with ChatGPT, Claude, and Cursor) the auth scope will automatically be set to read and write.

\n
When connecting via Personal Access Tokens (as described for Google Antigravity and OpenAI Codex), you have the option to choose between three scopes: read only, write only, read and write.
\n
 
\n
Therefore, if you wish to limit the scope to read only or write only, we recommend connecting via Personal Access Tokens instead of OAuth 2.
\n
How do I submit bugs or feedback for the MCP?

Please submit any bugs or feedback via this form. Thank you in advance!

Can I connect the Coda MCP to Claude Code using Personal Access Tokens, rather than OAuth? 
\n

Yes! In this article, we describe the process of connecting the MCP to Claude Code via OAuth. But if you instead wish to connect to the MCP using Personal Access Tokens, you can do so by following these steps: 

\n
  1. First, you’ll need to generate an auth token from your Coda account page. You can click here (or scroll to the API settings section of your account page, then click Generate API token). Give your token a memorable name, ensure that the restriction type is MCP, and choose the type of access. Then click the Generate API token button to create. Once created, click the Copy token button to copy it to your clipboard.
\n
\"generate
  1. Next, open a fresh terminal window and paste in the following block, making sure to replace the Your-Coda-Auth-Token section with the auth token you generated and copied in the previous step.
\n
claude mcp add --transport http Coda 
https://coda.io/apis/mcp --header 
\"Authorization: Bearer Your-Coda-Auth-Token\"
\n
  1. Confirm that your MCP got added correctly by pasting the following command into the terminal:
\n
claude mcp list
\n
  1. Start Claude Code by typing claude . into your terminal and ask it to connect to the Coda MCP.
\n
Connect to the Coda MCP
\n
 
\n
If successful, you’ll see a success message with Coda MCP tools. You can now start building in Coda using Claude Code!
\n
\"16_10

 

\n
Can I connect to Cursor using Personal Access Tokens, rather than OAuth?
\n

Yes! In this article, we describe the process of connecting the MCP to Cursor via OAuth. But if you instead wish to connect to the MCP using Personal Access Tokens, you can do so by following these steps:

\n
    \n
  1. Within your Cursor app, simply open up Cursor Settings and select the Tools & MCP section.
    2. \n
  2. Then click New MCP Server. This will open a new mcp.json file.
    1. Tip: Only enable the MCPs you are currently working with to save context and improve agent accuracy
    \n
    3. \n
  3. Next, you’ll need to generate an auth token from your Coda account page. You can click here (or scroll to the API settings section of your account page, then click Generate API token). Give your token a memorable name, ensure that the restriction type is MCP, and choose the type of access. Then click the Generate API token button to create. Once created, click the Copy token button to copy it to your clipboard.
    4. \n
\n
\"generate
  1. Now, inside your mcp.json file in Cursor, insert the following code, making sure to replace the Your-Coda-Auth-Token section with the auth token you generated and copied in the previous step.
\n
{  
   \"mcpServers\": {    
      \"Coda\": {
        \"url\": \"https://coda.io/apis/mcp\",
        \"headers\": {
          \"Authorization\": \"Bearer Your-Coda-Auth-Token\"
      }
    }
  }
}
\n
  1. Once you’ve made the above edits, the file should be saved automatically, and you should now be connected to the Coda MCP. You can verify by checking the tools list (under Tools & MCP) or asking Cursor about your tools in Coda. 
\n
\"1_1
  1. Tip: If you don’t see your MCP show up at this stage, restart Cursor.
\n
 
\n
 
\n
 

 

Related resources

 
","user_segment_ids":[]}}