How do I use @selibiks/bubble-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@selibiks/bubble-mcp search for users who signed up last month" 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.

@selibiks/bubble-mcp

by sELIBIKS

Overview Schema Related Servers Score Discussions

TypeScript

Remote

@selibiks/bubble-mcp

MCP server for Bubble.io with 28 tools across 3 layers — query data, audit schemas, seed test records, and more.

Quick Start

# Install dependencies
npm install

# Build
npm run build

# Start (requires configuration — see below)
npm start

Related MCP server: MCP Database Server

Configuration

Environment Variables

BUBBLE_APP_URL=https://your-app.bubbleapps.io
BUBBLE_API_TOKEN=your-api-token-here
BUBBLE_MODE=read-only
BUBBLE_ENVIRONMENT=development
BUBBLE_RATE_LIMIT=60

Variable	Required	Default	Description
`BUBBLE_APP_URL`	Yes	—	Your Bubble.io app URL
`BUBBLE_API_TOKEN`	Yes	—	API token from Bubble.io Settings > API
`BUBBLE_MODE`	No	`read-only`	`read-only`, `read-write`, or `admin`
`BUBBLE_ENVIRONMENT`	No	`development`	`development` or `live`
`BUBBLE_RATE_LIMIT`	No	`60`	Max requests per minute

Config File Alternative

Create bubble.config.json in the project root:

{
  "app_url": "https://your-app.bubbleapps.io",
  "api_token": "your-api-token-here",
  "mode": "read-only",
  "environment": "development",
  "rate_limit": 60
}

Environment variables take priority over the config file.

Claude Desktop / Claude Code Integration

Add to your Claude configuration:

{
  "mcpServers": {
    "bubble": {
      "command": "node",
      "args": ["/path/to/bubble-mcp/dist/index.js"],
      "env": {
        "BUBBLE_APP_URL": "https://your-app.bubbleapps.io",
        "BUBBLE_API_TOKEN": "your-api-token-here",
        "BUBBLE_MODE": "read-only",
        "BUBBLE_ENVIRONMENT": "development"
      }
    }
  }
}

Or via the CLI:

claude mcp add bubble -- node /path/to/bubble-mcp/dist/index.js

Security Model

Three-layer defence in depth:

Layer	What it does
Server Mode Gate	Filters tools by mode at startup (`read-only` < `read-write` < `admin`)
MCP Permissions	Claude prompts user approval before each tool invocation
Bubble Privacy Rules	Bubble.io enforces API-level access via the token's permissions

Input validation: All user-supplied identifiers (dataType, id, sort_field, workflow_name) are validated against safe character patterns before reaching API URLs. File paths (TDD tools) are sandboxed to the project directory.

Token safety: The API token is never exposed in responses or error messages. The bubble_get_environment tool explicitly excludes it.

Mode Reference

Capability	read-only	read-write	admin
Query data (search, get)	Yes	Yes	Yes
Inspect schema / Swagger docs	Yes	Yes	Yes
Create / update records	No	Yes	Yes
Trigger workflows	No	Yes	Yes
Delete records	No	No	Yes
Bulk operations	No	No	Yes
Seed / cleanup test data	No	No	Yes

Tool Reference (28 tools)

Core Tools (11)

Tool	Mode	Description
`bubble_get_schema`	read-only	Fetch the full app schema (all types and fields) from `/meta`
`bubble_search`	read-only	Search records with constraints, sorting, and pagination
`bubble_get`	read-only	Fetch a single record by type and ID
`bubble_create`	read-write	Create a new record
`bubble_update`	read-write	Partially update a record (PATCH)
`bubble_replace`	read-write	Replace a record entirely (PUT)
`bubble_delete`	admin	Permanently delete a record
`bubble_bulk_create`	admin	Create up to 1000 records in one call
`bubble_trigger_workflow`	read-write	Trigger a backend API workflow by name
`bubble_get_environment`	read-only	Return current server config (mode, environment, rate limit)
`bubble_swagger_docs`	read-only	Fetch the Swagger/OpenAPI spec for the connected app

Compound Tools (7)

Tool	Mode	Description
`bubble_schema_summary`	read-only	Type counts, relationships, and totals (lightweight vs full schema)
`bubble_privacy_audit`	read-only	Scan schema for sensitive fields, PII, and API write exposure
`bubble_find_orphans`	read-only	Find records with broken foreign key references
`bubble_record_validator`	read-only	Sample records and check for empty/null fields
`bubble_search_all`	read-only	Auto-paginate through all records of a type (up to 10k)
`bubble_field_usage`	read-only	Analyse field population rates and identify dead fields
`bubble_compare_environments`	read-only	Diff schemas between development and live environments

Developer Tools (10)

Tool	Mode	Description
`bubble_health_check`	read-only	Privacy audit + dead field detection with a 0-100 score
`bubble_export_schema`	read-only	Export schema as TDD-format markdown
`bubble_workflow_map`	read-only	List all API workflows and their parameters
`bubble_tdd_validate`	read-only	Validate a TDD markdown file against the live schema
`bubble_migration_plan`	read-only	Generate ordered migration steps from a TDD file
`bubble_wu_estimate`	read-only	Estimate Workload Units for a Bubble operation
`bubble_suggest_indexes`	read-only	Suggest fields that would benefit from indexes
`bubble_option_set_audit`	read-only	Find text fields that should be option sets
`bubble_seed_data`	admin	Seed test data in dependency order (tracked for cleanup)
`bubble_cleanup_test_data`	admin	Delete all previously seeded test data

Swagger / OpenAPI

The bubble_swagger_docs tool fetches the auto-generated Swagger spec from your Bubble app:

https://your-app.bubbleapps.io/api/1.1/meta/swagger.json

If you get an error, enable Swagger docs in Bubble: Settings > API > Enable Swagger documentation.

Development

npm install          # Install dependencies
npm run dev          # Development mode (tsx, no build needed)
npm run build        # Compile TypeScript to dist/
npm test             # Run all tests (179 tests)
npm run test:watch   # Tests in watch mode
npm run lint         # ESLint
npm run format       # Prettier
npm run typecheck    # tsc --noEmit

Defaults

Setting	Default	Why
Mode	`read-only`	Safe — no mutations possible
Environment	`development`	Safe — won't touch production
Rate limit	60 req/min	Prevents API abuse

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

DB-Mcp
Entertainment & Media
xiaobenyang-com
A
license
-
quality
D
maintenance
MCP Database Server is a service that provides secure database access for AI assistants and LLM-based tools, supporting SQLite, PostgreSQL, MySQL and MariaDB, and featuring query verification, audit logs and security control functions.
Updated 7 months ago (2026-01-09 07:05 UTC)
2
Apache 2.0
MCP Database Server
Databases Data Visualization
zerogon1203
F
license
-
quality
D
maintenance
A secure multi-database MCP server supporting MySQL, PostgreSQL, and SQLite with read-only enforcement, SQL injection prevention, and tools for schema analysis, performance optimization, and visualization.
Updated 10 months ago (2025-10-23 03:21 UTC)
4
Supabase MCP
Databases Cloud Platforms Developer Tools
node2flow-th
A
license
-
quality
D
maintenance
MCP server for Supabase, enabling database CRUD, storage management, auth administration, project management, edge functions, and secrets via 31 tools.
Updated 6 months ago (2026-02-14 19:49 UTC)
12
MIT
mcp-backend
Databases Cloud Storage Developer Tools
nla-agent
A
license
B
quality
C
maintenance
MCP server providing backend access to PostgreSQL, Storage (Supabase/S3), Iceberg data lake, and SQL seeds. It offers 32 tools for database queries, storage operations, seed management, and more.
Updated 3 months ago (2026-05-10 01:21 UTC)
31
3
MIT

View all related MCP servers

Related MCP Connectors

mcp
Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys.
Supabase
MCP server for interacting with the Supabase platform
royal-mcp
Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sELIBIKS/bubble-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

@selibiks/bubble-mcp

Quick Start

Configuration

Environment Variables

Config File Alternative

Claude Desktop / Claude Code Integration

Security Model

Mode Reference

Tool Reference (28 tools)

Core Tools (11)

Compound Tools (7)

Developer Tools (10)

Swagger / OpenAPI

Development

Defaults

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

DB-Mcp

MCP Database Server

Supabase MCP

mcp-backend

Related MCP Connectors

Latest Blog Posts

MCP directory API