← Back to directory
B

Butterbase

Community
AI-native, open-source backend-as-a-service with Postgres, auth, storage, functions, AI gateway, and MCP server.
GitHub source repository ↗
★ 3.3k Stars Category · Cloud Storage Very popular Source revision ce7057ff46a6
55FMRS · C
Reliability
7/20
Security and permissions
11/20
Maintenance
15/20
Documentation
13/20
Setup experience
9/20

Butterbase is a feature-rich open-source BaaS with strong MCP server integration, suitable for developers building AI applications. Its strength lies in its all-in-one backend service, but the open-source version is still young, posing stability risks, and some advanced features are only available to managed users.

Read the FMRS scoring method →

Butterbase is an open-source, AI-native backend-as-a-service platform that provides a comprehensive set of backend capabilities: Postgres data plane (with row-level security), serverless functions, LLM gateway, realtime subscriptions, key-value store, file storage, RAG, durable per-key actors, and a built-in Model Context Protocol (MCP) server, enabling AI agents to operate your backend with tools instead of glue code. It supports both self-hosting and managed offerings.

Tools

The tool list has not been reviewed yet.

Setup

  1. Clone the repository (with submodules): git clone --recurse-submodules https://github.com/butterbase-ai/butterbase.git
  2. Install dependencies: npm ci
  3. Copy environment config: cp .env.example .env
  4. Start the stack: docker compose -f docker-compose.local.yml up -d
  5. Run database migrations: set environment variables as required and execute npm run migrate:all
  6. Seed the local dev user: npm run seed:dev

(The MCP server is available via the npm package @butterbase/mcp or the HTTP endpoint https://api.butterbase.ai/mcp)

claude_desktop_config.json
{
  "mcpServers": {
    "butterbase": {
      "command": "npx",
      "args": [
        "-y",
        "@butterbase/mcp"
      ],
      "env": {
        "BUTTERBASE_API_KEY": "bb_sk_..."
      }
    }
  }
}

Fit and risk

Best for

  • Developers building AI-native applications
  • Teams needing a self-hosted BaaS
  • Projects wanting to expose backend capabilities to AI agents

Not for

  • Non-technical users requiring fully managed services
  • Enterprises with high demands for stability and production support
  • Scenarios with simple backend needs that only require a single feature

Required permissions

  • Requires a Butterbase API key (bb_sk_...) for API access
  • If self-hosting, requires Docker and Node.js 22+
  • May need to configure infrastructure such as Postgres, Redis, S3/R2

Risks and side effects

  • The open-source version is young (v0.2.0) and may have unnoticed bugs
  • Some features (e.g., multi-region orchestration, billing) are only in the managed private repo; self-hosted version is limited
  • The AI gateway lacks upstream router adapters, requiring custom implementations

Troubleshooting

  1. Check that the API key is set correctly
  2. Confirm the service is running (control API health check)
  3. Inspect Docker logs and Postgres connections
  4. Ensure database migrations have been executed correctly

Use cases

Building AI-driven applications with rapid backend setup
Providing backend management interfaces for AI agents
Quickly developing, testing, and deploying backend features

Supported clients

Claude DesktopFull support