The Superhuman Docs MCP (Model Context Protocol) is a connection layer that enables AI clients - like Cursor, Claude, etc. - to read and write to your Docs using plain-language prompts. Instead of clicking through the Docs 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 Superhuman Docs 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 Superhuman Docs MCP. Once you've connected, you can check out this article for some helpful guidance and examples on using the Docs MCP.

Supported clients

Connect ChatGPT with Docs MCP

1. Within ChatGPT, click into the Apps tab of the left panel
2. Enter "Coda" in the search bar
3. Select Coda from the search results, then click Connect
   1. Note: 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.

4. Click Sign in with Coda

   

5. A new tab will open, where you will be prompted to sign into Coda/Docs and grant ChatGPT the necessary access.
6. Once authentication has been completed, you'll be redirected back to ChatGTP and should see a Coda is now connected confirmation.

Connect Claude Chat & Cowork with Docs MCP

1. Ensure you are logged into Claude
2. Follow this link to access the native connector: https://claude.ai/directory/connectors/superhuman-docs 
3. Click the Connect button
   1. If the Connect button is not available, this most likely means that your Claude account is part of a Team or Enterprise plan, and your admin has not yet enabled this connector for your organization. In this case, we suggest reaching out to your admin to request access to this connector, then resuming the connection process as described here. See the FAQs below for more info on this.
4. Follow the prompts to allow Claude access to Superhuman Docs
5. Once authorized, you’re all set. You can start taking actions in Docs with Claude!

Connect Claude Code with Docs MCP

1. To start, open a fresh terminal window and run the following block:

claude mcp add --transport http SuperhumanDocs https://docs.superhuman.com/apis/mcp

2. Once the above has run, type Claude into your terminal and hit Enter
3. Then type /mcp into the terminal and hit Enter again.
4. You should now see a notice that Superhuman Docs MCP needs authentication. Click Enter and select Authenticate.
5. This will open a browser window where you'll be asked to allow Claude Code access to Docs. 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.
6. To confirm connection to the Docs MCP, return to your terminal window and enter the following:

Are you connected to the Superhuman Docs MCP?

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

Connect Copilot Studio with Docs MCP

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

1. First, you’ll need to generate a Personal Access Token from your Superhuman Docs 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.

   

2. Next, within Copilot Studio, open the agent you want to connect to the MCP.
3. From the menu across the top of the agent page, select Tools, then click the + Add a tool button.
4. Within the Create new options, select Model Context Protocol.
5. Enter the following info:
   1. Server name and Server Description: fill these in as you see fit (for instance, "Superhuman Docs MCP" and "Superhuman Docs MCP to read and write to docs"
   2. Server URL: https://docs.superhuman.com/apis/mcp
   3. Authorization: Select the API Key option. Then for the Type choose Header, and for the Header name enter Authorization
6. Once all the above info has been entered, hit Create.
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. In the hidden field, enter the following string: Bearer Your-Docs-Auth-Token - making sure to replace Your-Docs-Auth-Token with the token you generated in step 1.
   1. For instance, Bearer 1bxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
9. Hit Create button to finalize the connection.

Connect Cursor with Docs MCP

1. Within your Cursor app, simply open up Cursor Settings and select the Tools & MCP section.
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
3. Inside your mcp.json file in Cursor, insert the following code:

{  
   "mcpServers": {    
      "SuperhumanDocs": {
        "url": "https://docs.superhuman.com/apis/mcp"
    }
  }
}

4. Once you’ve made the above edits, the file should be saved automatically, and you should now be connected to the Superhuman Docs MCP. You can verify by checking the tools list (under Tools & MCP) or asking Cursor about your tools in Docs. 
   1. Tip: If you don’t see your MCP show up at this stage, restart Cursor.

Connect OpenAI Codex CLI with Docs MCP

1. First, you’ll need to generate an auth token from your Superhuman Docs 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.

   

2. Open a fresh terminal window and paste the block below into it, making sure to replace the Your-Docs-Auth-Token section with the auth token you generated and copied in the previous step.

codex mcp add SuperhumanDocs -- npx -y mcp-remote https://docs.superhuman.com/apis/mcp --header "Authorization: Bearer Your-Docs-Auth-Token"

3. Start Codex by typing codex into your terminal. You should be all set and can start using the Docs MCP!
    

Connect Google Antigravity with Docs MCP

1. First, you’ll need to generate an auth token from your Superhuman Docs 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.

   

2. 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. 

   

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-Docs-MCP-Auth-Token section with the auth token you generated and copied in the previous step.

{
  "mcpServers": {
    "SuperhumanDocs": {
      "serverUrl": "https://docs.superhuman.com/apis/mcp",
      "headers": {
        "Authorization": "Bearer Your-Docs-MCP-Auth-Token"
      }
    }
  }
}

4. Save your settings, and hit refresh in Antigravity (if it doesn’t automatically refresh on its own). Superhuman Docs should now appear as an available MCP tool in Antigravity.

   

    

FAQs

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

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: 

1. First, you’ll need to generate an auth token from your Superhuman Docs 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.

2. Next, open a fresh terminal window and paste in the following block, making sure to replace the Your-Docs-Auth-Token section with the auth token you generated and copied in the previous step.

claude mcp add --transport http SuperhumanDocs 
https://docs.superhuman.com/apis/mcp --header 
"Authorization: Bearer Your-Docs-Auth-Token"

3. Confirm that your MCP got added correctly by pasting the following command into the terminal:

claude mcp list

4. Start Claude Code by typing claude . into your terminal and ask it to connect to the Docs MCP.

Connect to the Superhuman Docs MCP

 

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

{  
   "mcpServers": {    
      "SuperhumanDocs": {
        "url": "https://docs.superhuman.com/apis/mcp",
        "headers": {
          "Authorization": "Bearer Your-Docs-Auth-Token"
      }
    }
  }
}

Related resources

• Using the Superhuman Docs MCP
• Security recommendations for Docs MCP
• Getting started with Superhuman Docs MCP | Guides