mcp-baserow

This MCP server, mcp-baserow, provides a seamless bridge between MCP-compatible clients and Baserow. It exposes authentication, workspace, database, table, and row operations so you can manage your Baserow data using natural language queries from MPC clients like Claude Desktop, Cursor, Windsurf, or any MCP-enabled editor. After starting the server, configure your MCP client to connect to the baserow MCP server and begin issuing natural language requests such as listing workspaces, creating databases, or adding rows. The server handles authentication token refreshes (via username/password) or accepts a manually supplied JWT/database token for advanced use cases. Tools are organized into categories: Authentication, Workspace, Database, Table, and Row Operations, enabling you to perform end-to-end interactions with Baserow entirely through natural language or scripted MCP tool calls.

Prerequisites:

• Node.js v22+ installed (recommended via nvm)
• npm (comes with Node.js)
• Git

Installation steps:

1. Clone the repository

git clone https://github.com/ayyazzafar/mcp-baserow.git
cd mcp-baserow

2. Install dependencies

npm install

3. Configure authentication (example)

cp .env.example .env

Edit the .env with your credentials (or use other supported auth methods documented below):

# Recommended: Use credentials for automatic token refresh
BASEROW_USERNAME=your@email.com
BASEROW_PASSWORD=your_password

# Optional: Override default API URL for self-hosted instances
# BASEROW_API_URL=https://your-baserow-instance.com

4. Build the project

npm run build

5. Run the server

# Depending on your setup, you may run the built index directly
node dist/index.js

6. (Optional) Start via a script or PM2 for production

pm2 start dist/index.js --name mcp-baserow

Tips and notes:

• The server supports multiple authentication modes: (a) Username/Password for automatic token refresh, (b) JWT Token for manual token management, and (c) Database Token for database-scoped access. Set the appropriate environment variables accordingly.
• If you use a self-hosted Baserow instance, set BASEROW_API_URL in the environment to point to it.
• Common issues include authentication failures, missing workspace IDs, and client log warnings. Ensure .env (or equivalent env vars) is loaded when starting the server and that you’re using Node.js v22+.
• MCP clients may require restarting after configuration changes. Check client logs for detailed error messages if you encounter problems.
• The project structure includes src for TypeScript sources and dist for compiled JavaScript. Run npm run build to generate dist/index.js before starting the server.