# Connect Cursor to NocoDB

> Part of the NocoDB documentation (MCP Server > Connect). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL.

URL: https://nocodb.com/docs/mcp/cursor
Last updated: 2026-10-21

Connect Cursor to NocoDB with the NocoDB MCP server: add the JSON block from your MCP connection as a custom MCP server in the MCP tab of Cursor Settings.

Cursor works with NocoDB through the NocoDB MCP server. You paste the JSON block from your MCP connection in NocoDB into the MCP settings of Cursor.

|                     | Cursor                                                                 |
| ------------------- | ---------------------------------------------------------------------- |
| **Type**            | Desktop                                                                |
| **How it connects** | JSON block, over HTTP                                                  |
| **You need**        | An [MCP connection](/docs/mcp/connections#server-configuration-nocodb) |

## Set up Cursor

Cursor connects directly to the MCP endpoint over HTTP. Thus it does not need the `mcp-remote` bridge. Its JSON block carries the endpoint URL and the token header.

1. Open **Cursor Settings** (`⇧+⌘+J`).
2. Open the **MCP** tab.
3. Select **Add Custom MCP**.
4. Paste the JSON block that you copied [here](/docs/mcp/connections#server-configuration-nocodb).
5. Save.

<Callout type="info">
   On success, you will see the number of tools enabled below the MCP Server just installed. If you see an error, double-check the JSON configuration. 
</Callout>

<img alt="Cursor MCP Settings" src={__img0} placeholder="blur" />

### Configuration example

Cursor and Windsurf connect over HTTP, so their block carries the endpoint URL and the token header. Cursor names the address `url`, and Windsurf names it `serverUrl`:

```json
{
  "mcpServers": {
    "NocoDB MCP": {
      "url": "https://your-domain.com/mcp/<ncId>",
      "headers": { "x-api-key": "<ncToken>" }
    }
  }
}
```

<Callout type="warning">
  The JSON block contains your MCP token, which gives access to your NocoDB projects. Do not put it in source control.
</Callout>

## Related

* [Connections and access](/docs/mcp/connections)
* [What the assistant can do](/docs/mcp#what-you-can-do)
* [All MCP clients](/docs/mcp#pick-your-client)

---

## Related pages

- [Connect Claude to NocoDB](https://nocodb.com/docs/mcp/claude.md): Connect Claude to NocoDB from the Claude Connectors directory with OAuth, add a custom connector for self-hosted NocoDB, or set up Claude Desktop manually.
- [Connect Claude Code to NocoDB](https://nocodb.com/docs/mcp/claude-code.md): Connect Claude Code to NocoDB with one command: add https://app.nocodb.com/mcp as an HTTP MCP server and sign in with OAuth, or use a token.
- [Connect ChatGPT to NocoDB](https://nocodb.com/docs/mcp/chatgpt.md): Connect ChatGPT to NocoDB with the NocoDB MCP server: create a connector with the URL https://app.nocodb.com/mcp and sign in to NocoDB with OAuth.
- [Connect Codex to NocoDB](https://nocodb.com/docs/mcp/codex.md): Connect the Codex CLI to NocoDB with the NocoDB MCP server: add the TOML block from your MCP connection to the Codex config file, then run codex mcp list.
- [Connect Windsurf to NocoDB](https://nocodb.com/docs/mcp/windsurf.md): Connect Windsurf to NocoDB with the NocoDB MCP server: add the JSON block from your MCP connection to the Cascade MCP plugins in Windsurf Settings.
- [Connect AntiGravity to NocoDB](https://nocodb.com/docs/mcp/antigravity.md): Connect AntiGravity to NocoDB with the NocoDB MCP server: paste the JSON block from your MCP connection into the raw MCP config of the agent window.