NocoDB

v1.0.0โ€ขDatabasesโ€ขstable

๐Ÿ“‡ โ˜๏ธ - Nocodb database integration, read and write capabilities

mcpmcp-servernocodb
Share:
70
Stars
0
Downloads
0
Weekly
0/5

What is NocoDB?

NocoDB is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐Ÿ“‡ โ˜๏ธ - nocodb database integration, read and write capabilities

๐Ÿ“‡ โ˜๏ธ - Nocodb database integration, read and write capabilities

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ๐Ÿ“‡ โ˜๏ธ - Nocodb database integration, read and write capabilit

Use Cases

Read and write data to NocoDB databases.
Manage cloud-hosted spreadsheet-like databases.
Query and manipulate NocoDB records through AI.
edwinbernadus

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 9, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx nocodb

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use NocoDB

The NocoDB MCP server integrates Claude and other AI assistants with NocoDB โ€” an open-source Airtable alternative that turns any database into a collaborative spreadsheet interface. Through this server, AI agents can perform full CRUD operations (create, read, update, delete) on NocoDB tables using natural language, including bulk operations and JSON file imports. It is useful for teams who manage structured data in NocoDB and want to automate data entry, reporting, or manipulation tasks directly through their AI assistant without writing API calls manually.

Prerequisites

  • Node.js 16+ and npm for building the server from source
  • A running NocoDB instance โ€” either self-hosted or at app.nocodb.com
  • A NocoDB API token from your account settings
  • Your NocoDB Base ID, found in the URL of your NocoDB base
  • An MCP-compatible client such as Claude Desktop
1

Clone the repository and build

Clone the nocodb-mcp-server repository and compile the TypeScript source. This generates the runnable dist/start.js file.

git clone https://github.com/edwinbernadus/nocodb-mcp-server.git
cd nocodb-mcp-server
npm install
npm run build
2

Gather your NocoDB credentials

You need three values: your NocoDB instance URL, your Base ID, and your API token. The Base ID appears in your browser URL when viewing a base (the segment after your username). Generate a token in NocoDB under Team & Settings > API Tokens.

# Example NocoDB URL structure:
# https://app.nocodb.com/#/your-team/BASE_ID/TABLE_ID
# The BASE_ID is the segment between your team and table.
3

Configure your MCP client

Add the NocoDB server to your Claude Desktop configuration using the three required environment variables. Adjust the path to dist/start.js to match your cloned directory.

{
  "mcpServers": {
    "nocodb": {
      "command": "node",
      "args": ["/path/to/nocodb-mcp-server/dist/start.js"],
      "env": {
        "NOCODB_URL": "https://app.nocodb.com",
        "NOCODB_BASE_ID": "your_base_id_here",
        "NOCODB_API_TOKEN": "your_api_token_here"
      }
    }
  }
}
4

Alternatively, run via npx with inline arguments

The server can also be invoked with arguments passed directly on the command line, avoiding the need to set environment variables in the config.

npx -y nocodb-mcp-server https://app.nocodb.com YOUR_BASE_ID YOUR_API_TOKEN
5

Restart your client and test the connection

Restart Claude Desktop after saving the configuration. Then ask Claude to list tables or retrieve data from a known table name to verify the connection is working.

NocoDB Examples

Client configuration

Full Claude Desktop configuration for the NocoDB MCP server with the three required credentials.

{
  "mcpServers": {
    "nocodb": {
      "command": "node",
      "args": ["/Users/yourname/nocodb-mcp-server/dist/start.js"],
      "env": {
        "NOCODB_URL": "https://app.nocodb.com",
        "NOCODB_BASE_ID": "p_abc123xyz",
        "NOCODB_API_TOKEN": "xc-token-your-token-here"
      }
    }
  }
}

Prompts to try

Natural language commands you can use with Claude once the NocoDB MCP server is connected.

- "Get all data from NocoDB table: Customers"
- "Add a new row to the Shinobi table with name: sasuke-2 and age: 17"
- "Update all rows in the Products table where category is 'Electronics', set stock to 0"
- "Delete all rows in the Orders table where status is 'Cancelled'"
- "Import this JSON data into a new table called ImportedData"

Troubleshooting NocoDB

Authentication error when connecting to NocoDB

Verify your NOCODB_API_TOKEN is a valid token from NocoDB's Team & Settings > API Tokens page. Tokens start with `xc-` for NocoDB Cloud. Ensure there are no extra spaces in the environment variable value.

Base ID not found or incorrect

Open your NocoDB base in a browser. The Base ID is visible in the URL after your workspace name and before the table name. It typically looks like `p_abc123xyz`. Copy it exactly without any trailing slashes.

Server builds but Claude cannot find the MCP tools

Confirm the path in `args` points to `dist/start.js` (not `dist/index.js`). After editing the config, fully quit and relaunch Claude Desktop โ€” a simple window close may not restart the MCP subprocess.

Frequently Asked Questions about NocoDB

What is NocoDB?

NocoDB is a Model Context Protocol (MCP) server that ๐Ÿ“‡ โ˜๏ธ - nocodb database integration, read and write capabilities It connects AI assistants to external tools and data sources through a standardized interface.

How do I install NocoDB?

Follow the installation instructions on the NocoDB GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with NocoDB?

NocoDB works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is NocoDB free to use?

Yes, NocoDB is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "nocodb": { "command": "npx", "args": ["-y", "nocodb"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use NocoDB?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides