Within this article, you’ll find...
- Supported clients
- Connect ChatGPT with Coda MCP
- Connect Claude Chat & Cowork with Coda MCP
- Connect Claude Code with Coda MCP
- Connect Cursor with Coda MCP
- Connect OpenAI Codex CLI with Coda MCP
- Connect Google Antigravity with Coda MCP
- FAQs
Supported clients
- ChatGPT
- Claude (including Claude Code, Claude Cowork, and Claude Chat)
- Cursor
- OpenAI Codex
- Google Antigravity
Connect ChatGPT with Coda MCP
ℹ️ At this time, you must have a paid ChatGPT plan to connect to the Coda MCP. Connecting to MCPs in ChatGPT requires turning on "developer mode," which is only available on paid plans.
- Within ChatGPT, click on your account name in the lower-left, select Settings, then click into the Apps tab.
- Select Advanced settings, then make sure the developer mode option is toggled on
-
Note that if an enterprise manages your ChatGPT account, you may not be able to turn on developer mode. You would need to contact an admin for your organization and request that they adjust the settings to allow you to access developer mode.
-
- Once developer mode has been enabled, click the Create app button.
- Now you can give this new connection a name, ensure OAuth is selected for the authentication type, and enter the following URL into the MCP Server URL field: https://coda.io/apis/mcp
- Note that this method of authentication automatically sets the scope of the connection to read & write. As of today, it isn't currently possible to change the scope to read only or write only.
- Once ready, check the box to confirm that you want to connect to the custom server, then click Create.
Connect Claude Chat & Cowork with Coda MCP
ℹ️ 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.
- To check your Node.js version, open Terminal (Mac) or Command Prompt (Windows) and run node --version. If the version is below v20.18.1, or you see command not found, then jump to the subsection below on installing Node.
- Check if you have multiple Node versions by running nvm ls in Terminal (Mac) or nvm list in Command Prompt (Windows). If you see multiple versions, you must follow the steps described in the subsection below before continuing — setup will fail otherwise.
- Open Claude
- In the lower-left corner, click on your account name, then select Settings
- Click into the Connectors section
- Scroll to the bottom of the list of connectors, and select Add custom connectors
-
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.” You will first need to have your admin modify your permissions before you can move forward with this process.
-
- Give your connector a name, then enter the following URL into the Remote MCP Server URL field: https://coda.io/apis/mcp
- Click Add
- Now find the newly added connector in the list, and click Connect
- Follow the prompts to allow Claude access to Coda
- Once authorized, you’re all set. You can start taking actions in Coda with Claude!
ℹ️ 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
Claude Desktop requires a tool called Node.js to run the Coda MCP connection. To install the latest version of Node, follow these steps:
- Hit Cmd+Space → Terminal to open Terminal.
- In Terminal, type or paste the following command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- Hit Enter.
- 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.
- 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
echoand one starts witheval. - Wait until you see the regular prompt again (ending with
%or$). Then install Node.js by pasting the following command:
brew install node
- Hit Enter.
- Verify everything is installed correctly by pasting the following command:
npx --version
- Hit Enter.
- If you see a version number (like
10.8.2), you're good to move on. If it sayscommand not found, try closing and reopening Terminal, then runnpx --versionagain.
If Node is installed but you’re still running into errors...
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:
Step 1: Find your Node 20 path
- Hit Cmd+Space → Terminal to open Terminal.
- In Terminal, type or paste the following command:
nvm which 20
- Hit Enter.
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.
If this command says N/A or fails, install Node 20 first:
nvm install 20
Then run nvm which 20 again.
Step 2: Connect to the Coda MCP via the Claude UI
- Follow the steps in the "Connect Claude Chat & Cowork to Coda MCP" section of this article.
Step 3: Clear the npm cache
- Hit Cmd+Space → Terminal to open Terminal.
- In Terminal, type or paste the following command:
rm -rf ~/.npm/_npx
- Hit Enter.
Step 4: Restart Claude Desktop
- Fully quit and reopen Claude Desktop.
- The MCP Server should now connect successfully.
Windows users: The steps are the same, with a few differences:
- To find your Node 20 path, run
nvm which 20in Command Prompt. - Open Command Prompt by hitting Win+R, typing
cmd, and hitting Enter. - The path will look like
C:\Users\yourname\AppData\Roaming\nvm\v20.x.x. - When updating your config, set
"command"to that path followed bynpx.cmd, and update the new"PATH"to use that same folder with semicolons instead of colons. - To clear the npm cache, run
rmdir /s /q %LOCALAPPDATA%\npm-cache_npx.
Connect Claude Code with Coda MCP
-
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.
- 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.
claude mcp add --transport http Coda
https://coda.io/apis/mcp --header
"Authorization: Bearer Your-Coda-Auth-Token"
- Confirm that your MCP got added correctly by pasting the following command into the terminal:
claude mcp list
- Start Claude Code by typing
claude .into your terminal and ask it to connect to the Coda MCP.
Connect to the Coda MCP
ℹ️ Troubleshooting & Tips:
- If you have already used another MCP that accesses Coda: Use claude mcp remove <mcp-name> in this case.
- If you have directories named “Coda” in your filepath: Change directory and try again.
Connect Cursor with Coda MCP
- Within your Cursor app, simply open up Cursor Settings and select the Tools & MCP section.
- Then click New MCP Server. This will open a new mcp.json file.
- Tip: Only enable the MCPs you are currently working with to save context and improve agent accuracy
-
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.
- 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.
{
"mcpServers": {
"Coda": {
"url": "https://coda.io/apis/mcp",
"headers": {
"Authorization": "Bearer Your-Coda-Auth-Token"
}
}
}
}-
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.
- Tip: If you don’t see your MCP show up at this stage, restart Cursor.
ℹ️ To learn more about connecting MCPs in Cursor, please refer to Cursor’s documentation.
Connect OpenAI Codex CLI with Coda MCP
-
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.
- 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.
codex mcp add Coda -- npx -y mcp-remote
https://coda.io/apis/mcp --header
"Authorization: Bearer Your-Coda-Auth-Token"
- Start Codex by typing
codexinto 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
-
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.
-
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.
- 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.
{
"mcpServers": {
"Coda": {
"serverUrl": "https://coda.io/apis/mcp",
"headers": {
"Authorization": "Bearer Your-Coda-MCP-Auth-Token"
}
}
}
}-
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.
ℹ️ 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?
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 authentication tokens to complete the connection.
Do I have to be a Doc Maker to connect to the Coda MCP?
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.
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?
When connecting the Coda MCP via OAuth 2 (as with ChatGPT and Claude Chat) the auth scope will automatically be set to read and write.
How do I submit bugs or feedback for the MCP?
Please submit any bugs or feedback via this form. Thank you in advance!
Related resources
- Using the Coda MCP
- Security recommendations for Coda MCP
- Getting started with Coda MCP | Coda Guides