Pocketbase MCP Server

This is an MCP server that interacts with a PocketBase instance. It allows you to fetch, list, create, update, and manage records and files in your

Local serverstdioTypeScript

What is the Pocketbase MCP MCP server?

This is an MCP server that interacts with a PocketBase instance. It allows you to fetch, list, create, update, and manage records and files in your PocketBase collections. The pocketbase mcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it rather than through you.

Adding it to your client

The server ships on npm as @smithery/cli, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Configuration

You will need 4 environment variables: POCKETBASE_API_URL, POCKETBASE_ADMIN_TOKEN, YOUR_POCKETBASE_API_URL, YOUR_POCKETBASE_ADMIN_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the pocketbase mcp mcp server does with a few real requests.

When to reach for it

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. It is maintained by mabeldata; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Pocketbase MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

How to install the Pocketbase MCP MCP server

{
      "mcpServers": {
        // ... other servers might be listed here ...

        "pocketbase-mcp": {
          "command": "node",
          "args": ["/path/to/pocketbase-mcp/build/index.js"],
          "env": {
            "POCKETBASE_API_URL": "<YOUR_POCKETBASE_API_URL>", // e.g., "http://127.0.0.1:8090"
            "POCKETBASE_ADMIN_TOKEN": "<YOUR_POCKETBASE_ADMIN_TOKEN>"
          },
          "disabled": false, // Ensure it's enabled
          "autoApprove": [
            "fetch_record",
            "list_collections",
            "get_collection_schema",
            "list_logs",
            "get_log",
            "get_logs_stats",
            "list_cron_jobs",
            "run_cron_job"
          ] // Suggested auto-approve settings
        }

        // ... other servers might be listed here ...
      }
    }

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
POCKETBASE_API_URLEndpoint or connection string the server talks to.Yes
POCKETBASE_ADMIN_TOKENCredential the server authenticates with.Yes
YOUR_POCKETBASE_API_URLEndpoint or connection string the server talks to.Yes
YOUR_POCKETBASE_ADMIN_TOKENCredential the server authenticates with.Yes

Frequently asked questions

It connects Pocketbase MCP to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Pocketbase MCP directly.