How to connect NocoDB to Claude

Connect Claude Web, Desktop and Cowork to NocoDB MCP. List all projects updated this week, add a new record to clients table, and more using natural language, with authentication handled for you.

NocoDB logoNocoDB
Api KeyApi Key

NocoDB is a free, open-source Airtable alternative that turns any database into a smart spreadsheet with REST APIs. Easily manage and collaborate on data without vendor lock-in or steep learning curves.

27 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your NocoDB account to Claude via Composio Connect, enabling it to list all projects updated this week, add a new record to Clients table, update status of Task ID 42 to Done, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate NocoDB with

Connecting NocoDB to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your NocoDB account

Back in Claude, ask it to connect to NocoDB or give it any NocoDB-related task.

For example, ask Claude to:

  • "List all projects updated this week"
  • "Add a new record to Clients table"
  • "Update status of Task ID 42 to Done"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your NocoDB account is ready to use.

What is the NocoDB Claude Connector, and what's possible with it?

The NocoDB MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your NocoDB account. It provides structured and secure access so your agent can perform NocoDB operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for NocoDB?

The connector can show as connected, but Claude must use it in each NocoDB conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to NocoDB again.

2. Why does Claude show an MCP server error before NocoDB connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for NocoDB.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect NocoDB.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the NocoDB authorization link not work?

The Composio connector is one server. Your NocoDB account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the NocoDB connection.
  • Composio creates a fresh NocoDB authorization link.
  • Open that link in your browser and finish the NocoDB sign-in.

4. Why do NocoDB actions fail after they worked before?

The NocoDB connection can expire or lose permission.

  • Ask Claude to inspect the NocoDB connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the NocoDB account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in NocoDB.
  • If the action still fails with a permission error, check that the connected account has that permission in NocoDB itself.

5. How do I switch to a different NocoDB account?

Claude can manage the NocoDB connection for you.

  • Ask Claude to disconnect or delete the current NocoDB account.
  • Ask Claude to connect NocoDB again.
  • Open the new Composio authorization link for NocoDB.
  • Sign in with the other NocoDB account in the browser.
  • After the account connects, ask Claude to retry the NocoDB task.

6. Why is my NocoDB connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your NocoDB connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click and click Clear cache.
  • If NocoDB tools still do not appear, click , disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect NocoDB.
TOOLS

Supported Tools

Every NocoDB action and event your agent gets out of the box.

Get User Info

Tool to get authenticated user information including email, name, roles, and profile details.

Forgot Password

Tool to initiate password reset process by sending a reset email to the user.

Sign Out User

Tool to sign out the authenticated user and clear their refresh token from the database and cookie.

Get Sort Metadata

Tool to retrieve sort configuration by ID from NocoDB.

Update View Column

Tool to update a column configuration in a view.

Delete View

Tool to delete a view from a NocoDB table.

Delete Table View Row

Tool to delete a specific row from a table view in NocoDB.

Get Integration Info

Tool to retrieve metadata for a specific NocoDB integration by type and subtype.

List Integrations

Tool to retrieve all available integrations in NocoDB.

Store Integration Configuration

Tool to store configuration for a NocoDB integration.

Delete Notification

Tool to delete a notification for the authenticated user.

List Notifications

Tool to retrieve paginated notification records for the authenticated user.

Poll Notifications

Tool to poll for notifications using long-polling mechanism.

Get Plugin Status

Tool to check if a NocoDB plugin is active or not.

List Public Shared View Grouped Data

Tool to retrieve grouped data from a publicly shared NocoDB view.

Upload Attachments by URL

Tool to upload attachments from remote URLs to NocoDB storage.

Get Table Schema

Tool to retrieve complete schema information for a specific table.

Update User Profile

Tool to update authenticated user's profile information including display name, first name, and last name.

Get Aggregated Meta Info

Tool to get aggregated meta information such as tableCount, dbViewCount, viewCount and other statistics about the NocoDB instance.

Get Application Health Status

Tool to get the NocoDB application health status.

Get Application Info

Tool to get comprehensive NocoDB application information including authentication settings, version, limits, and deployment configuration.

Get Cloud Features

Tool to get NocoDB Cloud features.

Get Command Palette Suggestions

Tool to get dynamic command palette suggestions based on scope.

Report Error

Tool to report errors to NocoDB's error tracking system.

Get Product Feed

Tool to get NocoDB product feed from social media sources including GitHub, YouTube, Twitter, and Cloud.

Convert URL to Database Config

Tool to convert JDBC URL or database connection URL to connection configuration object.

List Workspace Bases

Tool to list all bases in a NocoDB workspace.

FAQ

Frequently asked questions

With a standalone NocoDB MCP server, the agents and LLMs can only access a fixed set of NocoDB tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from NocoDB and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right NocoDB tools.

Yes, absolutely. You can configure which NocoDB scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your NocoDB data and credentials are handled as safely as possible.

Start with NocoDB.It takes 30 seconds.

Managed auth, hosted MCP servers, and every NocoDB tool your agent needs.Free to start.

Start building