Baserow MCP

Connect your AI agent to Baserow. Your agent can read and build databases, automations, dashboards and applications in one Baserow workspace, using only the tools you allow.

This repo installs Baserow's MCP server and short skills that teach the agent how to use it: baserow-basics for rows and anything missing, baserow-databases for databases, tables, fields and views, baserow-automations for workflows, baserow-dashboards for dashboards, baserow-app-builder for application builders, and baserow-workspace for search, row comments and the audit log. It works with Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi and other agents.

Server URL

• baserow.io: https://api.baserow.io/mcp
• Self-hosted: your backend URL followed by /mcp, for example https://baserow.example.com/mcp. Copy it from My settings → MCP server in Baserow.

The examples below use the baserow.io URL. On self-hosted Baserow, use your own URL instead.

Quick start

npx add-mcp https://api.baserow.io/mcp -n baserow -g
npx skills add baserow/baserow-mcp

add-mcp finds the agents you have installed and asks which ones to add Baserow to. Untick Claude Desktop if it's listed and add Baserow there as a custom connector instead. skills add copies the skills into your agents' skill folders. On self-hosted Baserow, run skills add too, since only the plugins below include the skills.

Self-hosted requirements

• A Baserow version newer than 2.4.1. Older versions don't have /mcp or sign-in; use an endpoint key there.
• BASEROW_MCP_OAUTH_ENABLED=true on the backend. It's off by default.
• A public HTTPS backend URL, so hosted apps like Claude.ai and ChatGPT can reach it, and outbound HTTPS from the backend, which fetches the apps' client metadata.
• Your reverse proxy sends /mcp and paths under /mcp/, /oauth/, /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource to the backend. Match /mcp exactly, not as a prefix: the frontend serves the sign-in page at /mcp-authorize/.

See MCP OAuth sign-in for self-hosted Baserow.

Install per agent

Agent	baserow.io	Self-hosted
Claude Code	Plugin	Same plugin, enter your URL when asked
Claude.ai, Claude Desktop	Custom connector	Same, with your URL
ChatGPT	Custom MCP server	Same, with your URL
Codex	Plugin	codex mcp add baserow --url <your url>
GitHub Copilot CLI	Plugin	Server only
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Add to Cursor	Config file
VS Code	Add to VS Code	Config file
Goose	Add to Goose	Quick start with your URL
OpenCode, Windsurf, Zed	Config file	Same, with your URL
Any other agent	Quick start	Same, with your URL

The Codex, Copilot and Gemini plugins and the Add to buttons always point at baserow.io, so on self-hosted Baserow add only the server for those agents.

Claude Code

/plugin marketplace add baserow/baserow-mcp
/plugin install baserow@baserow

When it asks for the URL, press Esc to keep baserow.io, or enter your self-hosted URL. To change it later, run /plugin configure baserow@baserow.

Claude.ai and Claude Desktop

Customize → Connectors → + Add → Add custom connector. Name it Baserow and enter your server URL. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.

ChatGPT

Open Plugins, select the plus button, then Add custom MCP server, and enter your server URL. Menu names change often. On Business and Enterprise plans an admin has to allow custom MCP servers first.

Codex

codex plugin marketplace add baserow/baserow-mcp
codex plugin add baserow@baserow
codex mcp login baserow

GitHub Copilot CLI

copilot plugin marketplace add baserow/baserow-mcp
copilot plugin install baserow@baserow

On self-hosted Baserow, add only the server: copilot mcp add --transport http baserow <your url>. If the plugin is installed, uninstall it first with copilot plugin uninstall baserow; its server replaces yours without a warning.

Config files

To add only the server, without the plugin:

• Cursor, ~/.cursor/mcp.json:

  { "mcpServers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }

• VS Code, .vscode/mcp.json:

  { "servers": { "baserow": { "type": "http", "url": "https://api.baserow.io/mcp" } } }

• OpenCode, opencode.json, then opencode mcp auth baserow:

  { "mcp": { "baserow": { "type": "remote", "url": "https://api.baserow.io/mcp" } } }

• Windsurf, ~/.codeium/windsurf/mcp_config.json:

  { "mcpServers": { "baserow": { "serverUrl": "https://api.baserow.io/mcp" } } }

• Zed, settings:

  { "context_servers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }

Signing in

Your agent opens a Baserow page in your browser. Sign in, pick the workspace and tick the tools the agent may use. The tools are grouped by what they do:

• Workspace: search everything the user can see.
• Databases: read databases, tables, fields, views, rows and row comments; create and change them, including view sorts, hidden fields and row colours, and post comments; delete rows, fields, views, filters and row colours.
• Automations: read workflows and their nodes; create automations and workflows, change nodes, and publish or pause workflows; delete nodes.
• Dashboards: read dashboards and widget figures; create dashboards and widgets and change them; delete widgets.
• Application builders: read pages, data sources, elements and actions; create and change applications, pages, elements, actions, styles and themes, and set up login; delete table columns and menu items.
• Audit log: read who did what in the workspace. Needs an advanced or enterprise licence and a workspace admin.

The Read only preset is ticked on a first connection. It covers search and reading databases, dashboards and application builders, so turn on anything else you want the agent to use. Row comments, row colours and charts need a premium licence. Which tools you see depends on your Baserow version.

Where the sign-in starts:

• Claude Code: run /mcp, pick plugin:baserow:baserow and authenticate.
• Codex: codex mcp login baserow.
• Gemini CLI: /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor and VS Code: the Connect or Sign in button next to the server.

To change the tools, click Edit tools next to the app under My settings → MCP server in Baserow. The app gets the change on its next request, without signing in again. New tools stay off for existing connections until you turn them on here.

To change the workspace, sign in again: re-authenticate the server in your agent, or disconnect the app under My settings → MCP server and connect again. A plain reconnect keeps the old sign-in. Do the same to change the tools on a version without Edit tools.

Troubleshooting

• A tool is missing, or no databases are listed. The connection only has the workspace and tools you picked. Turn the tool on with Edit tools, or sign in again for another workspace, as described above. Your agent may need a new session to see the change.
• The sign-in never starts, or the client says the server doesn't support OAuth or client registration. On self-hosted Baserow, check the self-hosted requirements.
• The connection fails with a URL you typed. Copy the URL exactly as My settings → MCP server shows it. It ends in /mcp, with no trailing slash.
• Two Baserow servers in Claude Code. If claude mcp list shows the plugin's plugin:baserow:baserow and a baserow server you added by hand, keep the one that connects. claude plugin disable baserow@baserow turns off the plugin's; claude mcp remove baserow removes yours.

Endpoint keys

Baserow 2.4.1 and older only accept an endpoint key, and the plugin doesn't set this up. Copy the endpoint URL from My settings → MCP server. It ends in /sse and contains your key. Add it by hand to an agent that supports SSE servers, such as Claude Code, Cursor or VS Code; Codex and Goose don't:

npx add-mcp "<endpoint url>" -t sse -n baserow -g -a claude-code

Newer versions also accept the key as a header on /mcp, which is useful for scripts:

npx add-mcp https://baserow.example.com/mcp -n baserow -g -a claude-code -h "Authorization: Bearer <key>"

The key gives full access to its workspace. -g writes it to your user config instead of the current folder, so it can't end up in a commit.

Privacy and support

• Privacy policy: https://baserow.io/privacy-policy
• Terms: https://baserow.io/terms-and-conditions
• Help: community forum or contact us

Developing

In scripts/, run npm install, then npm test and npm run check. CI runs the same checks. The tooling lives there so plugin installs don't install its dependencies.

The Claude Code plugin declares its server in .claude-plugin/plugin.json, so it can use the URL you enter. .mcp.json holds the baserow.io URL for other tools that read Claude-format plugins, such as GitHub Copilot CLI and Cursor.

License

MIT