How do I install Baserow Schema MCP?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Baserow Schema MCP need an API key?

The publisher lists these environment variables: BASEROW_API_URL, BASEROW_USERNAME, BASEROW_PASSWORD, BASEROW_TOTP_SECRET.

What transport does Baserow Schema MCP use?

Baserow Schema MCP runs locally over stdio.

When was Baserow Schema MCP last checked?

Last checked 2026-11-09. Generic Baserow API client MCP server with automatic 2FA (TOTP) auth and OpenAPI validation.

Baserow Schema MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

BASEROW_API_URL — Base URL of your Baserow instance, e.g. https://baserow.example.com
BASEROW_USERNAME — Baserow account email
BASEROW_PASSWORD — Baserow account password
BASEROW_TOTP_SECRET — Base32 TOTP secret of your Baserow account's 2FA (totp) setup

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1BASEROW_API_URL=<value> BASEROW_USERNAME=<value> BASEROW_PASSWORD=<secret> BASEROW_TOTP_SECRET=<secret> claude mcp add io.github.aficiomaquinas-mcp-baserow-schema -- npx -y mcp-baserow-schema@2.0.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.aficiomaquinas-mcp-baserow-schema": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "BASEROW_API_URL": "<value>",11        "BASEROW_USERNAME": "<value>",12        "BASEROW_PASSWORD": "<secret>",13        "BASEROW_TOTP_SECRET": "<secret>"14      }15    }16  }17}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 2.0.2

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

mcp-baserow-schema

MCP server for Baserow: a generic Baserow API client with 2FA authentication (TOTP) and OpenAPI validation.

One tool, the entire Baserow REST API. Schema changes (tables, fields, views, filters), row CRUD, workspace admin — anything documented in the OpenAPI spec is callable, with JWT auth handled automatically.

Why

Baserow's official MCP handles curated data CRUD but not the full API surface (schema changes, views, filters, admin endpoints). In 2026, plain password auth without 2FA is not acceptable. This MCP solves both:

Full API access: any endpoint from the bundled Baserow OpenAPI spec via one generic tool
2FA support: automatic TOTP-based authentication — no manual token management
OpenAPI guard: requests are validated against the spec; mistyped paths get a hint instead of a mystery 404
Designed for agents: AI agents can modify table structure without human intervention

Tools (2)

`baserow_api`

Generic HTTP client for any Baserow API endpoint.

Parameter	Type	Description
`method`	`GET` \| `POST` \| `PATCH` \| `DELETE` \| `PUT`	HTTP method
`path`	string	API path starting with `/api/`
`body`	object, optional	JSON body for POST/PATCH/PUT
`query`	object, optional	Query params as string key-value pairs

Examples:

GET    /api/database/tables/database/123/                    → list tables in database 123
POST   /api/database/views/table/456/       {name, type}     → create view
POST   /api/database/views/789/filters/     {field, type, value} → create filter
DELETE /api/database/tables/456/                             → delete table
PATCH  /api/database/rows/table/456/11/    {status}   ?user_field_names=true → update row
POST   /api/database/rows/table/456/batch/ {items:[...]}      → batch update

Auth is handled automatically: just provide method, path, and optional body/query. If the OpenAPI spec doesn't recognize the path/method, the response is prefixed with a warning (⚠️ OpenAPI spec: ...) including similar paths — the request still executes (validation is non-blocking).

`auth_status`

Returns the current authentication state: authenticated, token expiry, and remaining lifetime of access/refresh tokens. Useful for debugging the auth lifecycle.

OpenAPI Validation

The server bundles the official Baserow OpenAPI spec (v2.2.2, 275 paths, openapi.json at the repo root). Before each request:

Path + method found → request proceeds silently.
Path exists, method wrong → warning lists the available methods for that path.
Path unknown → warning plus up to 5 similar paths from the spec.

The spec is loaded lazily from dist/../openapi.json; if missing, validation is skipped gracefully and requests proceed unvalidated.

Authentication

Supports Baserow's two-step 2FA flow:

POST /api/user/token-auth/ → temporary 2FA token (~60 s)
POST /api/two-factor-auth/verify/ (with TOTP code) → JWT access_token + refresh_token
POST /api/user/token-refresh/ → new access_token, silently (no 2FA needed)

Token lifecycle:

access_token: ~10 minutes (expiry read from the JWT exp claim, refreshed 2 min before expiry)
refresh_token: ~7 days (full 2FA re-login 5 min before expiry)
temp_token: ~60 seconds (only for the 2FA verify step)

Credentials are passed via environment variables — never hardcoded.

Setup

Prerequisites

Node.js ≥ 20
Baserow account with 2FA enabled
Baserow TOTP secret (base32)

Install

git clone [email protected]:aficiomaquinas/mcp-baserow-schema.git
cd mcp-baserow-schema
npm install
npm run build

Configure

Set environment variables (or use a .env file — see .env.example):

BASEROW_API_URL=https://your-baserow-instance.com
[email protected]
BASEROW_PASSWORD=your_password
BASEROW_TOTP_SECRET=YOUR_BASE32_TOTP_SECRET

Hermes Agent

Add to ~/.hermes/profiles/<profile>/config.yaml:

mcp_servers:
  baserow-mcp:
    command: node
    args:
      - /path/to/mcp-baserow-schema/dist/index.js
    enabled: true
    env:
      BASEROW_API_URL: https://baserow.example.com
      BASEROW_USERNAME: [email protected]
      BASEROW_PASSWORD: your_password
      BASEROW_TOTP_SECRET: YOUR_BASE32_TOTP_SECRET

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "baserow-schema": {
      "command": "node",
      "args": ["/path/to/mcp-baserow-schema/dist/index.js"],
      "env": {
        "BASEROW_API_URL": "https://baserow.example.com",
        "BASEROW_USERNAME": "[email protected]",
        "BASEROW_PASSWORD": "your_password",
        "BASEROW_TOTP_SECRET": "YOUR_BASE32_TOTP_SECRET"
      }
    }
  }
}

Field Types

Since baserow_api is a pass-through client, every Baserow field type is supported — the JSON body just needs to match the API contract for the endpoint. Reference list of field types:

text, long_text, url, email, number, rating, boolean, date, last_modified, last_modified_by, created_on, created_by, duration, link_row, file, single_select, multiple_select, phone_number, formula, count, rollup, lookup, multiple_collaborators, uuid, autonumber, password, ai

Endpoint details: consult the bundled openapi.json or the Baserow API docs.

Usage with Official Baserow MCP

Since v2, this MCP covers data operations too (rows, batches, search, sort), so the official Baserow MCP is optional:

mcp-baserow-schema → everything: schema, data, views, filters, admin
Official Baserow MCP → curated row-CRUD UX, if you prefer it for data work

Running both side by side is fine; they don't conflict.

Releasing

Maintainers: see docs/RELEASING.md. Releases are fully automated (release-it + GitHub Actions with OIDC trusted publishing) — never bump versions, tags, or server.json manually.

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Baserow Schema MCP?

Does Baserow Schema MCP need an API key?

What transport does Baserow Schema MCP use?

When was Baserow Schema MCP last checked?

Documentation

mcp-baserow-schema

Why

Tools (2)

baserow_api

auth_status

OpenAPI Validation

Authentication

Setup

Prerequisites

Install

Configure

Hermes Agent

Claude Desktop

Field Types

Usage with Official Baserow MCP

Releasing

License

`baserow_api`

`auth_status`