pocketbase-mcp-server MCP Server

Model Context Protocol Server for PocketBase

This is a TypeScript-based MCP server that provides:

• Tools for listing PocketBase collections

Features

Tools

• pocketbase_list_collections - List all collections from a PocketBase instance
  • Requires server to be started with PocketBase configuration
  • Returns JSON representation of all collections

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

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

PocketBase Configuration

To enable the PocketBase collections tool, you must provide the following configuration either as command line arguments or environment variables:

• --pb-url=<url> or PB_URL - The URL of your PocketBase instance (e.g., http://localhost:8090)
• --pb-admin-email=<email> or PB_ADMIN_EMAIL - Admin email for authentication
• --pb-admin-password=<password> or PB_ADMIN_PASSWORD - Admin password for authentication

If using environment variables, you can set them like this:

export PB_URL=http://localhost:8090
export PB_ADMIN_EMAIL=admin@example.com
export PB_ADMIN_PASSWORD=your-secure-password

Example using command line arguments:

node build/index.js --pb-url=http://localhost:8090 --pb-admin-email=admin@example.com --pb-admin-password=your-secure-password

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.