Skip to content
PocketBase Cloud MCP

Let your AI assistant build on PocketBase, safely.

Connect Claude, ChatGPT, Cursor or VS Code. Your assistant manages projects, PocketBase instances, deploys, domains and data. It is told to try schema and hook changes on a preview first, and every file change it makes can be undone.

Server URL
https://mcp.pocketbasecloud.com/mcp

Paste it exactly: the address ends in /mcp.

  • OAuth sign-in
  • ·Read-only mode
  • ·Scope to one project
my-app — zsh
# add the server to Claude Code
$ claude mcp add --transport http pocketbasecloud \
   https://mcp.pocketbasecloud.com/mcp
# or give it read-only access
$ claude mcp add --transport http pocketbasecloud \
   "https://mcp.pocketbasecloud.com/mcp?read_only=true"
✓ run /mcp, choose pocketbasecloud and sign in
# add the server to Claude Code
$ claude mcp add --transport http pocketbasecloud https://mcp.pocketbasecloud.com/mcp
Connect

One URL, every assistant.

The server speaks MCP over HTTP with OAuth sign-in. Pick your assistant and follow its steps, then sign in when it asks.

  1. 01Open Customize → Connectors and click Add custom connector.
  2. 02Paste the server URL. If Claude asks how it should identify itself, choose Register automatically.
  3. 03Click Add, then Connect next to the new connector. Sign in and choose the access and the project.
Access

Narrow or widen what it can touch.

Add options to the server URL. read_only and project_ref only narrow what you approved when signing in. features chooses the tool groups, and adding an opt-in group gives the assistant more tools.

  • Read-only?read_only=true

    Expose only the tools that read.

  • One project?project_ref=<project id>

    Limit every tool to a single project.

  • Tool groups?features=account,resources,deploy,domains,database,docs,env

    Choose which groups of tools the assistant sees. This example adds env, so environment variable values pass through the conversation.

How it works

Preview, revision, undo.

The PocketBase Cloud MCP server gives Claude, ChatGPT, Cursor and VS Code the same safe path you use: preview, revision, undo.

  1. Connect your assistant

    Add one URL to Claude, ChatGPT, Cursor or VS Code and sign in. Choose read-only, or limit it to one project.

    Connect your assistant
    # server URL
      https://mcp.pocketbasecloud.com/mcp
    ✓ signed in · project "shop"
    ✓ access: read and write
  2. It works on a preview

    Ask for a change. Schema and code changes go to a preview first: a copy of your project with its own URL, so live keeps running.

    It works on a preview
    # you: add a reviews collection
      create_preview shop → shop-reviews
      apply_collections reviews (4 fields)
    ✓ preview ready, with its own URL
  3. Ship it, or undo it

    Ship the preview when it looks right. Every file change is a revision, so you can restore any of them from History.

    Ship it, or undo it
      ship_preview shop-reviews → shop
    ✓ live · revision #42
    # changed your mind?
      restore_revision #41
Tools

What can your assistant do?

54 tools in 8 groups. Environment variables and database admin are opt-in: add them to features to turn them on.

  • Account & projects

    account
    • list_projects
    • get_project
    • create_project
    • get_plan
    • list_regions
    • get_overview
  • Resources

    resources
    • list_resources
    • get_resource
    • create_pocketbase
    • update_pocketbase_config
    • set_continuous_backup
    • move_resource
    • delete_previous_copy
  • Deploys & logs

    deploy
    • get_logs
    • list_deployments
    • get_deployment
    • get_deploy_command
    • list_hooks
    • deploy_hooks
    • deploy_public
    • diagnose_resource
  • Custom domains

    domains
    • add_domain
    • verify_domain
    • check_domain
    • remove_domain
  • Database (inside an instance)

    database
    • list_collections
    • get_collection
    • list_records
    • get_request_logs
    • list_backups
    • list_crons
    • count_records
    • get_record
    • check_security
    • generate_types
    • preview_collections
    • check_performance
    • apply_collections
    • update_api_rules
    • create_record
    • create_records
    • update_record
    • create_backup
    • run_cron
    • delete_record
  • Docs

    docs
    • search_docs
  • Environment variables

    Opt-inenv
    • list_env_vars
    • set_env_vars
    • delete_env_vars
  • Database admin

    Opt-indatabase_admin
    • truncate_collection
    • delete_collection
    • remove_fields
    • restore_backup
    • delete_backup
Safety and data

You stay in control.

  • Approval for destructive tools

    Tools that delete or restore ask for your approval first.

  • System data is off limits

    Database tools reach your instance through PocketBase Cloud. System collections and instance settings are never touched.

  • Disconnect any time

    Signing in stores the connection you approved, with your PocketBase Cloud session encrypted inside it. Remove the connector in your assistant to stop using it. The server deletes the connection after 30 days without use, or sooner if you email [email protected].

  • Nothing kept from your instances

    The server never stores records, files or logs. It passes them to your assistant and forgets them. For reliability each tool call is recorded with the tool, its target, the outcome, a shortened error message and a pseudonymous account ID, and deleted after 90 days.

Give your assistant the keys.

Create a free PocketBase Cloud account, then add the server URL to your assistant.