butterbase

Butterbase Skills

Claude Code plugin for Butterbase — the AI-Native Backend-as-a-Service.

This plugin gives Claude deep knowledge of Butterbase's nearly 40 MCP tools, guides you through common workflows, and auto-configures the MCP server connection.

Installation

claude plugin marketplace add https://github.com/butterbase-ai/butterbase-skills
claude plugin install butterbase-skills@butterbase-skills

Setup

Sign-in is OAuth — no API key copy-paste needed.

1. Sign up at butterbase.ai.

2. Install the MCP server across every detected client with one command:

   npx @butterbase/cli mcp install
   

   This walks Claude Code, Cursor, VS Code, JetBrains, Codex, Gemini CLI, and the rest, and prints per-client OAuth follow-up hints.

3. Trigger OAuth once per client. In Claude Code: restart, then run /mcp (or claude mcp login butterbase). The cli's output covers every other client.

The plugin auto-loads its skills and CLAUDE.md context as soon as Claude Code starts. All tools are available immediately after consent.

Available Skills

Skills are namespaced by the plugin name, e.g. butterbase-skills:build-app.

Building blocks

Guided journey

butterbase-skills:journey takes an idea all the way to a deployed app, running these stages in order. Each stage can also be run on its own.

Slash commands

The plugin also ships 34 slash commands (in commands/) that invoke the skills directly, e.g. /butterbase-skills:journey, /butterbase-skills:schema, /butterbase-skills:deploy, /butterbase-skills:idea, /butterbase-skills:submit.

What's Included

• .mcp.json — Auto-configures the Butterbase MCP server connection (HTTPS endpoint)
• CLAUDE.md — Always-on context: environment variables, workflows, patterns, documentation references
• 39 skills and 34 slash commands — Guided workflows for building, deploying, debugging, and contributing, plus the end-to-end journey

Local Development

If you're running the Butterbase monorepo locally, the MCP server URL defaults to http://localhost:4000/mcp. Set this in your environment:

export CONTROL_API_URL=http://localhost:4000

Office clients

Hosted Butterbase MCP may expose the optional manage_office tool with 44 organization-scoped actions. Call butterbase_docs with topic: "office" before using it. Office uses a platform credential and an explicit org_id; it does not need an app. Equivalent interfaces are butterbase office --org <uuid> and SDK OfficeClient.

Enable, pause, resume and approve return a saved browser confirmation receipt. Show confirmation_url to the initiating owner, who signs in and reviews one operation. Never confirm as an agent. Observe status using confirmation_id. Keep Ask's request key and exact conversation/turn IDs; retry the same intended write with the same key and observe admitted work without submitting another Ask. Disconnecting does not cancel server work. Inspect unknown outcomes before retrying. See the Office client reference.

Also Available

• @butterbase/sdk — TypeScript SDK for client-side and server-side use
• @butterbase/cli — CLI tool for project scaffolding and backend management
• butterbase_docs MCP tool — Call with any topic (auth, storage, functions, etc.) for comprehensive reference docs

License

MIT

Curated organization context uses agent-memories / SDK agentMemories; default agent retrieval searches only this category. Other business memory requires an explicit category read. Compact title/summary lists precede full entry reads; context never overrides rules or permissions. Amend/archive require the current revision. Private per-person memory remains deferred.

skills supports separate list/detail/version/run pages, draft/test/reject and owner-confirmed approve/enable/rollback/run. principles amend/retire proposes governed changes. settings reads cadence and proposes revision-guarded 10/15/30/60-minute intervals without resuming paused work. Every-loop skills follow admitted full timer/event sweeps within a shared ten-minute budget; unchanged checks and Ask/test/manual/scheduled turns do not create loops. Extra runs can spend credits.

records list / SDK records.list / MCP list_office_records reads bounded resource pages (25 default, 100 maximum). Preserve organization, resource and filters with next_cursor; loaded counts are not totals and cutoff pagination is not a transaction-wide snapshot. Read the Office reference for the complete 44-action contract and payloads.