# Connect Claude 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/claude
Last updated: 2026-10-21

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.

NocoDB is in the Claude Connectors directory. Connect it from there, sign in to NocoDB, and Claude can work with your projects. You do not copy a token or edit a configuration file.

| Your NocoDB          | How to connect                                                                  |
| -------------------- | ------------------------------------------------------------------------------- |
| NocoDB Cloud         | [Connectors directory](#connect-from-the-connectors-directory)                  |
| Licensed self-hosted | [Custom connector](#self-hosted-nocodb) with your own URL                       |
| Community Edition    | [Claude Desktop with an MCP connection](#claude-desktop-with-an-mcp-connection) |

## Connect from the Connectors directory

1. In Claude, open **Settings** > **Connectors**, and browse the connectors directory.
2. Select **NocoDB**, then click **Connect**. The NocoDB authorization screen opens.
3. Sign in to NocoDB if it asks you to.
4. Below [**Access**](/docs/mcp/connections#connection-tools-and-access), add the projects that Claude can reach. Below **Tools & Permissions**, allow the tools that Claude can call.
5. Click **Authorize**. The connector shows as connected in Claude.
6. Try it: start a new chat and ask *"List my NocoDB workspaces and projects."*

<img alt="The NocoDB authorization screen" src={__img0} placeholder="blur" />

**Authorize** stays disabled until you add a minimum of one resource and allow a minimum of one tool.

## Self-hosted NocoDB

On a licensed self-hosted deployment, add NocoDB as a custom connector with the address of your instance.

1. In Claude, open [**Settings** > **Connectors**](https://claude.ai/settings/connectors) and click **Add custom connector**.
2. Type a name, and enter your server URL: `https://<your-nocodb-host>/mcp`. Click **Add**.
3. On the new connector, click **Connect**, then authorize as in step 3 to 5 above.

<img alt="The Add custom connector dialog" src={__img1} placeholder="blur" />

The server URL must be the public HTTPS address of your instance. NocoDB builds its sign-in addresses from `NC_SITE_URL` (or `NC_PUBLIC_URL`), so set it to that address.

## Tool permissions in Claude

Claude asks for your approval before it uses a NocoDB tool. To let Claude use a tool without asking, open **Settings** > **Connectors**, click **Configure** on the NocoDB connector, and set the tool to **Allow unsupervised**.

<img alt="Tool permissions of the NocoDB connector in Claude" src={__img2} placeholder="blur" />

## Claude Desktop with an MCP connection

Use an MCP connection when you want to pin Claude to the projects of one connection, or on the Community Edition, which has no OAuth.

1. [Create an MCP connection](/docs/mcp/connections#server-configuration-nocodb) and copy the JSON block from its **Claude Desktop** tab.
2. Open **Claude Desktop Preferences** (`⌘+,`). Under **Develop**, click **Edit Config**.
3. Insert the JSON block in `claude_desktop_config.json`, and save the file.
4. Restart Claude Desktop.

Claude Desktop starts the server as a local command, so the block runs the `mcp-remote` bridge:

```json
{
  "mcpServers": {
    "NocoDB MCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-domain.com/mcp/<ncId>",
        "--transport",
        "http-only",
        "--header",
        "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>

## Good to know

* A connector you add in Claude on the web also works in Claude Desktop and the Claude mobile apps.
* To see which workspaces and projects the connector can reach, ask Claude to use the **Get Project Info** tool.
* Only authorize projects and tools that you trust Claude to use for you.

## 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 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 Cursor to NocoDB](https://nocodb.com/docs/mcp/cursor.md): 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.
- [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.