NocoDB

NocoDB

Read and write access to NocoDB database.

55
Stars
22
Forks
0
Releases

Overview

The Nocodb MCP Server enables seamless interaction with your NocoDB database using the Model Context Protocol (MCP). This server exposes CRUD operations on NocoDB tables through natural language prompts, enabling users to get records, create and update records, delete records, and manage schema by adding or removing columns. It supports example prompts for common tasks such as Get Records, Create Record, Update Record, Delete Record, Add Column, and Delete Column. The server also supports uploading data by creating a table from JSON input (Upload File example with a JSON location). It is a TypeScript-based fork that retains core MCP functionality while improving maintainability and compatibility with modern TypeScript development practices. Setup involves Node.js and TypeScript, with commands like npm install and npm run build. Configuration relies on environment variables (NOCODB_URL, NOCODB_API_TOKEN, NOCODB_BASE_ID) and includes guidance on obtaining the base ID from the NocoDB URL. Integration options include Claude Desktop and direct CLI invocation, plus testing via CLI. Documentation for API functions is available in API_FUNCTION.md to describe the available endpoints and behavior.

Details

Owner
edwinbernadus
Language
JavaScript
License
Updated
2025-12-07

Features

Natural language CRUD prompts

Drive Get Records, Create Record, Update Record, and Delete Record operations on NocoDB tables via MCP prompts.

Column management

Add and delete columns in existing NocoDB tables through natural language prompts.

Upload data from JSON

Create a table from JSON input using the Upload File workflow and a provided JSON location.

CLI and direct invocation

Run the MCP server from the command line (e.g., npx nocodb-mcp-server) for quick access.

Claude Desktop integration

Configured via claude_desktop_config.json to enable Claude Desktop integration.

Environment-based configuration

Configure NOCODB_URL, NOCODB_BASE_ID, and NOCODB_API_TOKEN via a .env file.

TypeScript-based fork

A TypeScript-based fork focused on maintainability and modern TS development practices.

Documentation and API reference

API_FUNCTION.md provides detailed information about available API functions.

Audience

DevelopersBuild automation to access NocoDB via MCP using natural language prompts.
Data engineersAutomate data operations and schema changes in NocoDB with MCP prompts.
IntegratorsIntegrate MCP with CLI or Claude Desktop to control NocoDB via prompts.

Tags

NocoDBMCPCRUDNatural LanguageCLIClaude DesktopTypeScriptAutomationUpload from JSON