PocketBase MCP Server

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:

Build the server:

For development with auto-rebuild:

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

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:

Example using command line arguments:

Debugging

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

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