How to integrate NocoDB MCP with Atomic Agent

Connect Atomic Agent 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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including NocoDB.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a NocoDB account. See the Atomic Agent documentation for installation instructions.

Also integrate NocoDB with

How Atomic Agent connects to NocoDB

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect NocoDB to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in NocoDB. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your NocoDB account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the NocoDB MCP server, 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.

Use NocoDB from Atomic Agent

With your account connected, ask Atomic Agent to work with NocoDB in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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. Atomic Agent 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