PocketBase
About
Provides a TypeScript-based server for interacting with PocketBase, enabling flexible database management and configuration through natural language interfaces.
Details
- Author
- imiborbas
- Repository
- imiborbas/pocketbase-mcp-server
- GitHub stars
- 1
- Downloads
- 197
- Categories
- Design, Developer Tools, AI, Frontend, Infrastructure, Database, Other
Jump to
- Lists all collections from a PocketBase instance.
- Returns JSON representation of collections.
- Configurable via CLI arguments or environment variables.
- Built with TypeScript for reliable type safety.
- Compatible with MCP‑capable AI assistants and tools.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PocketBaseCommand (node, npx, python, etc.)nodeArguments-
Argument 1
build/index.js -
Argument 2
--pb-url=http://localhost:8090 -
Argument 3
--pb-admin-email=admin@example.com -
Argument 4
--pb-admin-password=your-secure-password
Environment-
PB_URL
http://localhost:8090 -
PB_ADMIN_EMAIL
admin@example.com -
PB_ADMIN_PASSWORD
your-secure-password
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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"
}
}
}
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
pocketbase_list_collections
List all collections from a PocketBase instance. Requires server to be started with PocketBase configuration and returns a JSON representation of all collections.
- pocketbase_list_collections - List all collections from a PocketBase instance
- Requires server to be started with PocketBase configuration
- Returns JSON representation of all collections
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"pocketbase": {
"env": {
"PB_URL": "http://localhost:8090",
"PB_ADMIN_EMAIL": "admin@example.com",
"PB_ADMIN_PASSWORD": "your-secure-password"
},
"args": [
"build/index.js",
"--pb-url=http://localhost:8090",
"--pb-admin-email=admin@example.com",
"--pb-admin-password=your-secure-password"
],
"command": "node"
}
}
}Linux
{
"env": {
"PB_URL": "http://localhost:8090",
"PB_ADMIN_EMAIL": "admin@example.com",
"PB_ADMIN_PASSWORD": "your-secure-password"
},
"args": [
"build/index.js",
"--pb-url=http://localhost:8090",
"--pb-admin-email=admin@example.com",
"--pb-admin-password=your-secure-password"
],
"command": "node"
}Macos
{
"env": {
"PB_URL": "http://localhost:8090",
"PB_ADMIN_EMAIL": "admin@example.com",
"PB_ADMIN_PASSWORD": "your-secure-password"
},
"args": [
"build/index.js",
"--pb-url=http://localhost:8090",
"--pb-admin-email=admin@example.com",
"--pb-admin-password=your-secure-password"
],
"command": "node"
}Windows
{
"env": {
"PB_URL": "http://localhost:8090",
"PB_ADMIN_EMAIL": "admin@example.com",
"PB_ADMIN_PASSWORD": "your-secure-password"
},
"args": [
"build/index.js",
"--pb-url=http://localhost:8090",
"--pb-admin-email=admin@example.com",
"--pb-admin-password=your-secure-password"
],
"command": "node"
}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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
