NocoDB MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with NocoDB MCP or direct API to read records, create new entries, update tables, and run database queries through natural language.

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

Try NocoDB now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
NocoDB
Try asking
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.

SETUP GUIDE

Connect NocoDB MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for NocoDB
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Show all active tasks in the Tasks table.'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect NocoDB API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute NocoDB Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List all records from the Projects table in NocoDB.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute NocoDB actions with your Agent

Why Use Composio?

AI Native NocoDB Integration

  • Supports both NocoDB MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your NocoDB data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke NocoDB access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access NocoDB
  • Scoped, least privilege access to NocoDB resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, NocoDB requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with NocoDB.It takes 30 seconds.

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

Start building