The PocketBase MCP Server enables AI assistants to comprehensively manage PocketBase backends through 23 tools covering database operations, authentication, file handling, and developer utilities.
Collection Management: Create, delete, update, list, and migrate collections with full schema configuration including fields, indexes, and access control rules. Truncate collections to preserve structure while removing data.
Record Operations: Perform CRUD operations with advanced filtering, sorting, pagination, field expansion, and data analysis capabilities. Execute complex queries with aggregation support.
Authentication & User Management: Authenticate as admin or user with email/password, create accounts with email verification, check auth status, manage auth collections, and configure auto-refresh tokens.
File Operations: Upload files from content or URLs, download files from record fields, and manage file field types in collections.
Access Control: Configure API rules for collections (list, view, create, update, delete) with rule-based permissions for fine-grained access control.
Data Management: Create backups in JSON/CSV formats, import data with create/update/upsert modes, perform batch operations, and transform data during migrations.
Index Management: Create, delete, and list database indexes for performance optimization.
Developer Tools: Generate TypeScript interfaces from PocketBase collections and vice versa, with support for relation types and configurable timestamps.
Server Utilities: Check server health, access field schema documentation, and reference API rules syntax.
Provides integration with PocketBase databases, offering tools for collection management, record operations, schema generation, authentication, and data analysis. Enables bidirectional conversion between TypeScript interfaces and PocketBase schemas.
Supports bidirectional conversion between TypeScript interfaces and PocketBase schemas, allowing users to generate TypeScript interfaces from PocketBase collections and create collections from TypeScript definitions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PocketBase MCP Serverlist all collections in my database"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
dynamic-pocketbase-mcp
Dynamic Model Context Protocol (MCP) server for PocketBase. Connect your AI client once, then manage collections and records in any PocketBase project using runtime tools.
Why this server is different
Many PocketBase MCP servers are static: they hardcode collection-specific behavior or require custom tool definitions per schema.
dynamic-pocketbase-mcp is dynamic:
Uses collection-agnostic tools (
list_collections,list_records,create_record, etc.)Works across existing and newly created collections without regenerating server code
Exposes live PocketBase collections as MCP resources
Related MCP server: PocketBase MCP Server
Features
18 MCP tools for health, auth, collections, rules, and records
Collection lifecycle operations (create, update, delete, inspect)
Record CRUD with filters, sorting, pagination, and field selection
Session-based auth via tools (
auth_admin,auth_user,get_auth_status,logout)Built-in references for field schema and rules syntax
Installation
Configure in an AI client
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
If POCKETBASE_URL is not set, the server defaults to http://localhost:8090.
Direct usage
Simple tutorial: chat with AI using this MCP
After you configure your MCP client, open a chat and try prompts like this:
"Set PocketBase URL to
https://pb.example.com.""Check my PocketBase server health."
"List all PocketBase collections."
"Authenticate as admin with email
<your-email>and password<your-password>.""Create a collection named
noteswith a requiredtitletext field.""Create a record in
noteswith titleFirst note.""Show all records in
notes, newest first.""Log out from PocketBase auth session."
If those steps succeed, your AI can now manage schema and data through this MCP server.
Authentication flow (via tools)
auth_adminorauth_userget_auth_statuslogout
Available tools
Health and references
health- Check PocketBase server health statusset_base_url- Update PocketBase URL for current MCP session and clear auth tokenget_field_schema_reference- Get field types documentationget_rules_reference- Get API rules syntax reference
Authentication
auth_admin- Authenticate as admin/superuserauth_user- Authenticate as auth collection user (email/username)get_auth_status- Check current authentication statuslogout- Clear authentication session
Collections
list_collections- List all collectionsview_collection- View collection by name or IDcreate_collection- Create new collectionupdate_collection- Update collection schema/settingsdelete_collection- Delete collectionupdate_collection_rules- Update access control rules
Records
list_records- List/search records with filtering, sorting, paginationview_record- View single record by IDcreate_record- Create new recordupdate_record- Update existing recorddelete_record- Delete record
Development
Environment variables
Variable | Required | Description |
| No | PocketBase server URL (default: |
License
MIT