Skip to main content
Glama
Baserow MCP
by baserow

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.

Related MCP server: fgac

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

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Experimental read-only MCP for Supabase application data: memory_search, memory_get and memory_list_recent under user-bound PostgreSQL RLS. Setup and demo: https://github.com/jryski/Supabase_user_MCP/blob/main/docs/GETTING_STARTED.md . Public preview is POSIX-only and synthetic-only; native Windows, hosted OAuth, one-click installation and writes are not available.
      Apache 2.0
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to securely access Gmail, Google Sheets, and Google Docs with fine-grained, deny-by-default permissions, including read/write restrictions, send whitelists, and one-click approvals.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to create, validate, and manage agent-powered workflows across team tools, with tools for inspecting schemas, configuring triggers, and reviewing runs and logs. It provides authorized remote access through OAuth without local installation or shared API keys.
      1
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to build and update complete applications, including creating, updating, publishing, previewing, and configuring databases, security, permissions, and server-side integrations.
      Apache 2.0