Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "baserow",
"displayName": "Baserow",
"version": "0.1.1",
"version": "1.0.0",
"description": "Read and build Baserow databases, automations, dashboards and applications from your AI agent through Baserow's MCP server.",
"author": { "name": "Baserow", "url": "https://baserow.io" },
"homepage": "https://baserow.io",
Expand All @@ -11,7 +11,7 @@
"mcp_url": {
"type": "string",
"title": "Baserow MCP URL",
"description": "Keep the default for baserow.io. For self-hosted Baserow, copy it from Settings → MCP server. It ends in /mcp.",
"description": "Keep the default for baserow.io. For self-hosted Baserow 3.0.0 or newer, copy it from My settings → MCP server. It ends in /mcp.",
"default": "https://api.baserow.io/mcp"
}
},
Expand Down
2 changes: 1 addition & 1 deletion .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "baserow",
"displayName": "Baserow",
"description": "Read and build Baserow databases, automations, dashboards and applications from your AI agent through Baserow's MCP server.",
"version": "0.1.1",
"version": "1.0.0",
"author": { "name": "Baserow", "url": "https://baserow.io" },
"homepage": "https://baserow.io",
"repository": "https://github.com/baserow/baserow-mcp",
Expand Down
8 changes: 8 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,14 @@ jobs:
exit 1
fi

- name: Check the changelog dates this version
run: |
VERSION=$(node -p 'require("./server.json").version')
if ! grep -Eq "^## ${VERSION//./\\.} \([0-9]{4}-[0-9]{2}-[0-9]{2}\)$" CHANGELOG.md; then
echo "CHANGELOG.md has no dated '## $VERSION (YYYY-MM-DD)' heading"
exit 1
fi

- name: Check the version isn't in the registry yet
id: registry
run: |
Expand Down
6 changes: 4 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,12 @@

Each release is tagged `v<version>`, matching the version in every manifest. Publishing a GitHub release for the tag publishes `server.json` to the MCP Registry.

## Unreleased
## 1.0.0 (unreleased)

Needs Baserow 3.0.0 or newer.

- New skills: `baserow-databases`, `baserow-automations`, `baserow-dashboards`, `baserow-app-builder` and `baserow-workspace`, for the database, automation, dashboard, application builder, search, row comment and audit log tools.
- `baserow-basics` covers rows, the shared error format and undo, and tells users to turn missing tools on with Edit tools in Settings.
- `baserow-basics` covers rows, the shared error format and undo, and tells users to turn missing tools on with Edit tools under My settings → MCP server.
- README and listing descriptions cover the new tools, tool groups and Edit tools.

## 0.1.1 (2026-10-16)
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ npx skills add baserow/baserow-mcp

## Self-hosted requirements

- A Baserow version newer than 2.4.1. Older versions don't have `/mcp` or sign-in; use an [endpoint key](#endpoint-keys) there.
- Baserow 3.0.0 or newer. Older versions don't have `/mcp` or sign-in; use an [endpoint key](#endpoint-keys) 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/`.
Expand Down Expand Up @@ -128,7 +128,7 @@ Where the sign-in starts:

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.
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.

## Troubleshooting

Expand All @@ -139,7 +139,7 @@ To change the workspace, sign in again: re-authenticate the server in your agent

### 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:
Without sign-in, on a Baserow version older than the [self-hosted requirements](#self-hosted-requirements) or with `BASEROW_MCP_OAUTH_ENABLED` off, use an endpoint key. 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
Expand Down
2 changes: 1 addition & 1 deletion gemini-extension.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "baserow",
"version": "0.1.1",
"version": "1.0.0",
"description": "Read and build Baserow databases, automations, dashboards and applications from your AI agent through Baserow's MCP server.",
"contextFileName": "GEMINI.md",
"mcpServers": {
Expand Down
2 changes: 1 addition & 1 deletion plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "baserow",
"version": "0.1.1",
"version": "1.0.0",
"description": "Read and build Baserow databases, automations, dashboards and applications from your AI agent through Baserow's MCP server.",
"author": { "name": "Baserow", "url": "https://baserow.io" },
"homepage": "https://baserow.io",
Expand Down
4 changes: 2 additions & 2 deletions server.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"name": "io.baserow/baserow",
"title": "Baserow",
"description": "Read and build Baserow databases, automations, dashboards and applications.",
"version": "0.1.1",
"version": "1.0.0",
"repository": {
"url": "https://github.com/baserow/baserow-mcp",
"source": "github"
Expand Down Expand Up @@ -35,7 +35,7 @@
"url": "https://{baserow_host}/mcp",
"variables": {
"baserow_host": {
"description": "Your self-hosted Baserow backend host, for example baserow.example.com",
"description": "Your self-hosted Baserow 3.0.0 or newer backend host, for example baserow.example.com",
"isRequired": true
}
}
Expand Down
5 changes: 2 additions & 3 deletions skills/baserow-basics/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,8 +62,7 @@ connections, and the "Read only" preset at sign-in only turns on search and the
tools for databases, dashboards and application builders. Ask the user to click Edit
tools next to the app under My settings → MCP server, and turn on the group with the
tool, such as "Edit databases" or "Read automations". The change applies without
signing in again, though some agents need a new session to see it. If there's no Edit
tools button, the user has to sign in again as above. With an endpoint key, tools can
only be changed through the API.
signing in again, though some agents need a new session to see it. With an endpoint
key, tools can only be changed through the API.

If no tool does what the user asks, say so and point them to Baserow.
Loading