{"id":27311686,"url":"https://github.com/edwinbernadus/nocodb-mcp-server","last_synced_at":"2025-07-06T20:37:29.772Z","repository":{"id":285993626,"uuid":"959950729","full_name":"edwinbernadus/nocodb-mcp-server","owner":"edwinbernadus","description":"nocodb mcp server","archived":false,"fork":false,"pushed_at":"2025-04-09T08:13:00.000Z","size":198,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-13T20:56:10.911Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/edwinbernadus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-03T16:04:04.000Z","updated_at":"2025-04-13T14:14:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"ce6ce92a-eead-4d5a-92c3-a0082c0a4475","html_url":"https://github.com/edwinbernadus/nocodb-mcp-server","commit_stats":null,"previous_names":["edwinbernadus/nocodb-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edwinbernadus%2Fnocodb-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edwinbernadus%2Fnocodb-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edwinbernadus%2Fnocodb-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edwinbernadus%2Fnocodb-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/edwinbernadus","download_url":"https://codeload.github.com/edwinbernadus/nocodb-mcp-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248782278,"owners_count":21160716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-12T06:03:06.647Z","updated_at":"2025-07-06T20:37:29.766Z","avatar_url":"https://github.com/edwinbernadus.png","language":"JavaScript","funding_links":[],"categories":["Databases","Database \u0026 Messaging MCP Servers","Community Servers","🗄️ \u003ca name=\"databases\"\u003e\u003c/a\u003eDatabases","MCP 服务器精选列表","پیاده‌سازی‌های سرور","📦 Other","MCP Servers","Task and Project Management","Data \u0026 Analytics","Uncategorized","Server Implementations"],"sub_categories":["Spreadsheets \u0026 No-Code","🗄️ 数据库交互","🗄️ \u003ca name=\"databases\"\u003e\u003c/a\u003eپایگاه‌های داده","🗄️ Databases","Uncategorized","🗄️ \u003ca name=\"databases\"\u003e\u003c/a\u003eDatabases"],"readme":"[![MseeP Badge](https://mseep.net/pr/edwinbernadus-nocodb-mcp-server-badge.jpg)](https://mseep.ai/app/edwinbernadus-nocodb-mcp-server)\n\n# NocoDB MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@edwinbernadus/nocodb-mcp-server)](https://smithery.ai/server/@edwinbernadus/nocodb-mcp-server)\n\n## Introduction\n\nThe NocoDB MCP Server enables seamless interaction with your NocoDB database using the Model Context Protocol (MCP). This server makes it easy to perform CRUD (Create, Read, Update, Delete) operations on NocoDB tables through natural language commands.\n\n## Example Prompt\n\n```text\n[Get Records]\nget data from nocodb, table: Shinobi\n\n[Create Record]\nadd new row, with name: sasuke-2\nadd other row, with name: naruto-2\n\n[Update Record]\nupdate all rows, remove suffix -\n\n[Delete Record]\ndelete all rows with name naruto\n\n[Add Column]\nadd column with name: Age\n\nupdate all rows, set Age to 18\n\n[Delete Column]\ndelete column with name: Age\n```\n\n## Example Prompt - Upload File\n\n```text\n[Create table]\nfrom the json files\nput on nocodb database\ntable name is TableShinobi\n```\nJSON location file in: [example_upload.json](example_upload.json)\n\n## Example Prompt - Bulk Create Records and Bulk Delete Records\n\n\n![bulk_sample1](https://raw.githubusercontent.com/edwinbernadus/nocodb-mcp-server/refs/heads/main/docs/sample-bulk/bulk-screen1.png)\n![bulk_sample2](https://raw.githubusercontent.com/edwinbernadus/nocodb-mcp-server/refs/heads/main/docs/sample-bulk/bulk-screen2.png)\n![bulk_sample3](https://raw.githubusercontent.com/edwinbernadus/nocodb-mcp-server/refs/heads/main/docs/sample-bulk/bulk-screen3.png)\n\n## About This Fork\n\nThis repository is a TypeScript-based fork of [NocoDB-MCP-Server](https://github.com/granthooks/Nocodb-MCP-Server). It retains the core functionality while improving maintainability and compatibility with modern TypeScript development practices.\n\n## Setup\n\nEnsure that Node.js and TypeScript are installed, then execute:\n\n```bash\nnpm install\nnpm run build\n```\n\n## Configuration\n\nDefine the required environment variables in a `.env` file:\n\n```env\nNOCODB_URL=https://your-nocodb-instance.com\nNOCODB_API_TOKEN=your_api_token_here\nNOCODB_BASE_ID=your_base_id_here\n```\n\n**Tip:** You can copy the template from [env.example](env.example) and fill in your values.\n\n### How to Obtain NOCODB_BASE_ID\n\nTo find your `NOCODB_BASE_ID`, check the URL of your Nocodb instance.  \nFor example:\nhttps://app.nocodb.com/#/wi6evls6/pqmob3ammcknma5/maty9c5xkmf4012  \nIn this URL format:\n\n```text\nhttps://app.nocodb.com/#/{USERNAME}/{NOCODB_BASE_ID}/{TABLE_ID}\n```\n\n## Integration with Claude Desktop\n\nModify `claude_desktop_config.json` to include:\n\n```json\n{\n  \"mcpServers\": {\n    \"nocodb\": {\n      \"command\": \"node\",\n      \"args\": [\"{working_folder}/dist/start.js\"],\n      \"env\": {\n        \"NOCODB_URL\": \"https://your-nocodb-instance.com\",\n        \"NOCODB_BASE_ID\": \"your_base_id_here\",\n        \"NOCODB_API_TOKEN\": \"your_api_token_here\"\n      }\n    }\n  }\n}\n```\n\n## Direct call from CLI\n\nYou can directly call the MCP server from the command line:  \nNOCODB_URL, NOCODB_API_TOKEN, and NOCODB_BASE_ID are required parameters.  \n`NOCODB_URL=https://app.nocodb.com` if you are using NocoDB cloud.\n\n```bash\nnpx -y nocodb-mcp-server {NOCODB_URL} {NOCODB_BASE_ID} {NOCODB_API_TOKEN} \n```\n\n## Testing CLI\n\nTo run the tests, execute:\n\n```bash\nnpx -y @wong2/mcp-cli npx nocodb-mcp-server {NOCODB_URL} {NOCODB_BASE_ID} {NOCODB_API_TOKEN} \n```\n\n## API Functions\n\nFor detailed information about available API functions, please refer to [API_FUNCTION.md](API_FUNCTION.md).\n\n## Project Structure\n\n```text\n/project-root\n  ├── src/            # TypeScript source files\n  ├── dist/           # Compiled JavaScript output\n  ├── .env            # Environment variable configurations\n  ├── package.json    # Project dependencies and scripts\n  ├── tsconfig.json   # TypeScript settings\n```\n\n## Contribution Guidelines\n\nContributions are encouraged! Feel free to open issues or submit pull requests.\n\n## License\n\nThis project is distributed under MIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedwinbernadus%2Fnocodb-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedwinbernadus%2Fnocodb-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedwinbernadus%2Fnocodb-mcp-server/lists"}