Skip to main content
Glama
fadlee

PocketBase MCP Server

by fadlee

PocketBase MCP Server

Model Context Protocol (MCP) server for PocketBase, enabling AI assistants to interact with your PocketBase backend.

Features

  • πŸ”§ 18 Tools for complete PocketBase management

  • πŸ“š Collections: Create, update, delete, and view collections

  • πŸ“ Records: Full CRUD operations with filtering, sorting, and pagination

  • πŸ” Authentication: Login/logout and check auth state via tools

  • πŸ” Rules: Manage API access control rules

  • πŸ“– References: Built-in field schema and rules reference

  • 🌐 Resources: Expose collections as MCP resources

Related MCP server: PocketBase MCP Server

Installation

npm install @fadlee/pocketbase-mcp # or bun install @fadlee/pocketbase-mcp

Usage

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{ "mcpServers": { "pocketbase": { "command": "npx", "args": ["@fadlee/pocketbase-mcp"] } } }

If POCKETBASE_URL is not set, server defaults to http://localhost:8090.

Direct Usage

# Use default URL (http://localhost:8090) npx @fadlee/pocketbase-mcp # Or use custom PocketBase URL POCKETBASE_URL=https://pb.example.com \ bunx @fadlee/pocketbase-mcp

Authentication Flow (via tools)

Use tools to authenticate after server starts:

  1. auth_admin or auth_user

  2. get_auth_status

  3. logout

Available Tools

Health & Reference

  • health - Check PocketBase server health status

  • get_field_schema_reference - Get field types documentation

  • get_rules_reference - Get API rules syntax reference

Authentication

  • auth_admin - Authenticate as admin/superuser

  • auth_user - Authenticate as auth collection user (email/username)

  • get_auth_status - Check current authentication status

  • logout - Clear authentication session

Collections

  • list_collections - List all collections

  • view_collection - View collection by name/ID

  • create_collection - Create new collection

  • update_collection - Update collection schema/settings

  • delete_collection - Delete collection

  • update_collection_rules - Update access control rules

Records

  • list_records - List/search records with filtering, sorting, pagination

  • view_record - View single record by ID

  • create_record - Create new record

  • update_record - Update existing record

  • delete_record - Delete record

Development

# Install dependencies bun install # Run in development mode bun run dev # Type check bun run typecheck # Run tests (builds dist first) bun run test # Run all checks (typecheck + tests) bun run check # Interactive release helper (bump, check, publish, push tag) bun run release # Build for production bun run build

Environment Variables

Variable

Required

Description

POCKETBASE_URL

No

PocketBase server URL (default: http://localhost:8090)

License

MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/fadlee/pocketbase-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server