home / mcp / pocketbase-mcp-server mcp server

pocketbase-mcp-server MCP Server

Model Context Protocol Server for PocketBase

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "imiborbas-pocketbase-mcp-server": {
      "command": "/path/to/pocketbase-mcp-server/build/index.js",
      "args": [
        "--pb-url=http://localhost:8090",
        "[email protected]",
        "--pb-admin-password=your-secure-password"
      ],
      "env": {
        "PB_URL": "http://localhost:8090",
        "PB_ADMIN_EMAIL": "[email protected]",
        "PB_ADMIN_PASSWORD": "your-secure-password"
      }
    }
  }
}

You run a Model Context Protocol (MCP) server that connects to PocketBase to expose a focused API for listing collections and other MCP-powered actions. This setup lets you manage PocketBase data sources efficiently from an MCP client, with a simple startup flow and built-in tools for inspection and automation.

How to use

Start the MCP server and connect your MCP client to the PocketBase instance. The server provides a dedicated tool for listing all PocketBase collections and makes it easy to pass authentication details so you can work with your data securely. Use the client to invoke the pocketbase_list_collections tool to retrieve the full JSON representation of your collections, or combine it with other MCP tools as part of automated workflows.

How to install

Prerequisites you need before starting the server.

npm install

Build the server so you can run it locally.

npm run build

For development with auto-rebuild, use the watch command.

npm run watch

Configure the server to connect to your PocketBase instance by placing the following MCP client config in your Claude desktop config (adjust the path to your environment). You will run the server from its built output and pass the PocketBase URL and admin credentials as arguments.

{
  "mcpServers": {
    "pocketbase-mcp-server": {
      "command": "/path/to/pocketbase-mcp-server/build/index.js --pb-url=http://localhost:8090 [email protected] --pb-admin-password=your-secure-password"
    }
  }
}

Additional sections

PocketBase configuration details that the MCP server expects are the PocketBase URL, the admin email, and the admin password. These are provided as either command line arguments or environment variables when you start the server.

--pb-url=<url> or PB_URL
--pb-admin-email=<email> or PB_ADMIN_EMAIL
--pb-admin-password=<password> or PB_ADMIN_PASSWORD

Debugging

MCP servers communicate over stdio, which can make debugging tricky. Use the MCP Inspector to access debugging tools in your browser.

npm run inspector

Available tools

pocketbase_list_collections

List all collections from a PocketBase instance and return their JSON representation. Requires PocketBase to be configured and running; outputs the current set of collections for use in MCP workflows.