Nocodb MCP Server logo

Nocodb MCP Server

by edwinbernadus

Connects MCP clients to NocoDB for natural-language table CRUD, column changes, and JSON-based data loading.

Install Nocodb MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "edwinbernadus-nocodb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "nocodb-mcp-server"
      ],
      "env": {
        "NOCODB_URL": "YOUR_VALUE_HERE",
        "NOCODB_API_TOKEN": "YOUR_VALUE_HERE",
        "NOCODB_BASE_ID": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y nocodb-mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

NocoDB table CRUD is exposed through the edwinbernadus/nocodb-mcp-server MCP server, allowing MCP clients to read, create, update, and delete records with natural-language requests. It connects to a NocoDB instance through a URL, API token, and base ID, and runs locally as a Node.js process over stdio. Reach for it when an agent needs to manage NocoDB tables, modify columns, perform bulk record operations, or load JSON data into a table.

Use cases

  • Read records from NocoDB tables through an MCP client
  • Create and update rows using natural-language requests
  • Modify table columns from an agent workflow
  • Load JSON data into a new NocoDB table
  • Perform bulk record creation or deletion

Key features

  • NocoDB table CRUD operations
  • Natural-language record management
  • Column addition and deletion
  • Bulk record creation and deletion
  • JSON-based table data loading
  • Claude Desktop configuration

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · nocodb-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars76Stargazers on the source repository.
npm downloads327Package downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Nocodb MCP Server works

What edwinbernadus/nocodb-mcp-server MCP server does

The edwinbernadus/nocodb-mcp-server MCP server connects an MCP client to a NocoDB database. It supports CRUD operations on NocoDB tables, so an agent can retrieve rows, create records, update existing data, and delete records through natural-language instructions.

The examples show requests that target a named table, add multiple rows, update matching data, and remove records that meet a condition. The server also supports schema changes in the demonstrated workflows, including adding a column, setting values in that column, and deleting the column afterward.

A separate example loads records from a JSON file into a newly created NocoDB table. The repository includes an example JSON file for this workflow. Screenshots in the documentation also cover bulk record creation and bulk deletion.

How it works

The server uses the Model Context Protocol to make NocoDB operations available to a compatible client. It communicates with the configured NocoDB instance using three required values: the instance URL, an API token, and the target base ID.

For local use, the project is written in TypeScript and compiled output is placed in the dist directory. Claude Desktop can start the compiled dist/start.js file with Node.js and pass the NocoDB settings through the client configuration.

The base ID is taken from the NocoDB URL. In the documented URL structure, it appears between the workspace or username segment and the table ID. NocoDB Cloud users should use https://app.nocodb.com as the service URL.

Setup and configuration

Install Node.js and TypeScript, then install the project dependencies and build the TypeScript source:

Terminal
npm install
npm run build

Create a .env file, or copy the repository's env.example template, and provide these settings:

  • NOCODB_URL: the NocoDB instance URL
  • NOCODB_API_TOKEN: the token used to access NocoDB
  • NOCODB_BASE_ID: the base containing the tables to manage

Claude Desktop configuration starts the compiled server with node and points its arguments to the local dist/start.js path. The same three values are supplied in the configuration's environment section. The documented configuration uses placeholder paths and credentials that must be replaced for a real deployment.

Tools and capabilities

The edwinbernadus/nocodb-mcp-server MCP server supports the following demonstrated operations:

  • Read records from a selected NocoDB table.
  • Create one or more records.
  • Update records, including changing values across matching rows.
  • Delete records that match a requested condition.
  • Add and remove table columns.
  • Populate a newly created table from JSON data.
  • Perform bulk record creation and deletion workflows.

Limitations and notes

The server requires access to a NocoDB instance and a valid API token; it is not a standalone database. The supplied setup instructions describe a locally built Node.js deployment and a Claude Desktop integration. A hosted deployment is also linked through Fronteir AI, but its endpoint details and operating conditions are not provided here.

The examples demonstrate natural-language requests, but they do not define the full query syntax, filtering behavior, pagination support, error handling, or available function list. Review the repository's API function documentation before relying on operations beyond the examples. The project is a TypeScript fork of an earlier NocoDB MCP server and is distributed under the MIT license.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Nocodb MCP Server

Clone or obtain the project, install Node.js and TypeScript, then run `npm install` followed by `npm run build`.

It requires `NOCODB_URL`, `NOCODB_API_TOKEN`, and `NOCODB_BASE_ID`. These can be placed in a `.env` file or supplied in a client configuration.

Yes. The README provides a Claude Desktop configuration that starts the compiled `dist/start.js` file with Node.js and passes the NocoDB settings as environment variables.

Yes. The documentation includes examples and screenshots for bulk record creation and bulk deletion.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNocodb MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/edwinbernadus-nocodb-mcp-server?style=directory)](https://allmcps.com/mcp/edwinbernadus-nocodb-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/edwinbernadus-nocodb-mcp-server"><img src="https://allmcps.com/api/badge/edwinbernadus-nocodb-mcp-server?style=directory" alt="Nocodb MCP Server on AllMCPs" /></a>