LABSCO SUMMARY
Your NocoDB tables, addressable by conversation.
The whole point is direct database work from a chat window — "add a row named X", "remove the suffix from every name", "delete rows named naruto" — including bulk operations and schema changes like adding a column. It talks to NocoDB over its API token, so the one setup step is finding your base id, which the README shows is just the middle part of the instance URL.
What it is
An MCP server for NocoDB that turns plain-language requests into CRUD operations over your database. It reads and writes table rows, and can add or remove columns, through the Model Context Protocol. This is a TypeScript fork of an earlier NocoDB MCP server.
What you get
- Records read from a named table
- Rows created, updated across matches, and deleted by criteria
- Bulk create and bulk delete of records
- Columns added to and removed from a table
- A table created from JSON files
Requirements
A NocoDB instance with an API token. NOCODB_URL, NOCODB_API_TOKEN and NOCODB_BASE_ID go in .env or the client's env block; the base id is the middle segment of a NocoDB URL. Install is a clone plus npm install and npm run build, launched as dist/start.js with node — or run directly via npx -y nocodb-mcp-server <YOUR_NOCODB_URL> <YOUR_NOCODB_BASE_ID> <YOUR_NOCODB_API_TOKEN>. The package.json names it nocodb-mcp-server at 1.0.24.
Setup effort
One command plus a key — npx -y nocodb-mcp-server <YOUR_NOCODB_URL> <YOUR_NOCODB_BASE_ID> <YOUR_NOCODB_API_TOKEN> , then supply credentials
USE CASES
Editing table data in plain language
Ask for the rows you want changed and let it update or delete across the matches.
Loading data in bulk
Create many records at once, or build a table straight from JSON files.
Adjusting a table's shape
Add a column, populate it across rows, then drop it again when it is no longer needed.
Reading what a table holds
Pull records from a named table to see its current contents.
BEFORE YOU INSTALL
What to know first
Requires
- node on PATH
- NOCODB_API_TOKEN in your environment
- NOCODB_URL in your environment
- NOCODB_BASE_ID in your environment
INSTALLATION
Connect your client
Server setup
npx -y nocodb-mcp-server <YOUR_NOCODB_URL> <YOUR_NOCODB_BASE_ID> <YOUR_NOCODB_API_TOKEN> MCP Clients
Claude Desktop
Clone the repository, then install and build (Node.js and TypeScript required):
git clone https://github.com/edwinbernadus/nocodb-mcp-server.git && cd nocodb-mcp-server && npm install && npm run buildAdd this to claude_desktop_config.json; <YOUR_WORKING_FOLDER> is the full path of your clone:
{
"mcpServers": {
"nocodb": {
"command": "node",
"args": [
"<YOUR_WORKING_FOLDER>/dist/start.js"
],
"env": {
"NOCODB_URL": "<YOUR_NOCODB_URL>",
"NOCODB_BASE_ID": "<YOUR_NOCODB_BASE_ID>",
"NOCODB_API_TOKEN": "<YOUR_NOCODB_API_TOKEN>"
}
}
}
}