Bubble Plan MCP server

Connect Bubble Plan to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy Bubble PlanBook a demo

What you can do with the Bubble Plan MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list subtasks tool in Bubble Plan
  • Use the list time entries tool in Bubble Plan
  • Use the list contacts tool in Bubble Plan
  • Use the list users & teams tool in Bubble Plan
  • Use the create comment tool in Bubble Plan
  • Use the list tasks tool in Bubble Plan

Supported Tools

list_subtasks

List Subtasks

Retrieve a list of subtasks from Project Bubble. Supports filtering by parent task, user, team, dates, and status.

list_time_entries

List Time Entries

Retrieve time entries from Project Bubble. Supports filtering by user, project, task, subtask, and date range. Useful for time tracking and reporting.

list_contacts

List Contacts

Retrieve contacts from Project Bubble. Contacts can be filtered by client. Contacts represent people associated with clients.

list_users

List Users & Teams

Retrieve the list of users and teams in the organization. Includes user profiles and team memberships. Also returns company information.

create_comment

Create Comment

Create a new comment on a project, task, or subtask. Supports replies by specifying a parent comment ID.

list_tasks

List Tasks

Retrieve a list of tasks from Project Bubble. Supports filtering by project, dates, tags, and status. Use this to browse tasks or find specific ones matching criteria.

create_contact

Create Contact

Create a new contact in Project Bubble. Contacts represent people associated with clients and can include phone, email, and role information.

create_subtask

Create Subtask

Create a new subtask under a parent task. Subtasks allow breaking work into smaller units within a task.

list_files

List Files

Retrieve files shared within projects, tasks, or subtasks. Files are stored as comments, so file deletion is handled through the comment deletion tool.

who_am_i

Get Current User

Retrieve the Project Bubble user authenticated by the connected API key.

list_events

List Events

Retrieve calendar events from Project Bubble. Supports filtering by project and date ranges.

list_clients

List Clients

Retrieve a list of clients from Project Bubble. Clients can be associated with projects and contacts.

list_comments

List Comments

Retrieve comments from Project Bubble. Filter by project, task, or subtask. Comments facilitate collaboration and can include file attachments.

create_project

Create Project

Create a new project in Project Bubble. A project serves as the top-level container for tasks, files, and collaboration. You can set dates, assign users/teams, configure billing, and more.

update_subtask

Update Subtask

Update an existing subtask in Project Bubble. Modify its name, description, dates, progress, or assignments. Also supports completing or resuming a subtask.

delete_contact

Delete Contact

Permanently delete a contact from Project Bubble.

create_time_entry

Create Time Entry

Log a time entry for a task in Project Bubble. Specify the duration in seconds, and optionally associate with a subtask.

update_event

Update Event

Update an existing calendar event in Project Bubble. Modify the name, dates, or project association.

delete_project

Delete Project

Permanently delete a project from Project Bubble. This removes the project and all of its associated data including tasks, subtasks, and files.

update_project

Update Project

Update an existing project in Project Bubble. Modify the name, description, dates, status, billing details, or team assignments. Only provided fields will be updated.

delete_time_entry

Delete Time Entry

Delete a Project Bubble time entry. Call list_time_entries to discover entry IDs.

update_task

Update Task

Update an existing task in Project Bubble. Modify the name, description, dates, progress, billing, or assignments. Also supports completing or resuming a task. Only provided fields will be updated.

delete_subtask

Delete Subtask

Permanently delete a subtask from Project Bubble.

delete_comment

Delete Comment

Delete a comment from Project Bubble. Deleting a comment also removes all replies and attached files.

create_task

Create Task

Create a new task within a project. Tasks can include descriptions, dates, billing info, and user/team assignments. Use the recurring option for repeating tasks.

create_client

Create Client

Create a Project Bubble client that can be associated with projects and contacts.

delete_event

Delete Event

Permanently delete a calendar event from Project Bubble.

get_project

Get Project

Retrieve detailed information about a specific project by its ID. Returns the project's name, description, dates, progress, assigned users and teams, and billing information.

create_event

Create Event

Create a new calendar event in Project Bubble. Events require a name, start date, and due date. Optionally associate with a project.

delete_task

Delete Task

Permanently delete a task from Project Bubble. This removes the task and all of its associated subtasks.

list_projects

List Projects

Retrieve a list of projects from Project Bubble. Supports filtering by client, dates, tags, and status. Use this to browse existing projects or find specific ones matching criteria.

update_contact

Update Contact

Update an existing contact in Project Bubble. Modify their name, email, phone, role, or client association.

Connect Bubble Plan to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Bubble Plan in Metorial. In your Metorial portal, enable the Bubble Plan MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Bubble Plan tools.

Run Bubble Plan through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Bubble Plan and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Bubble Plan tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Bubble Plan

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Technical notes for Bubble Plan

Manage projects, tasks, and subtasks for team collaboration. Create and update projects, organize task lists, track time and budgets, manage calendar events, and handle file sharing. Supports client management, comments on tasks, and user/team organization.

Frequently asked questions

Common questions about connecting Bubble Plan to AI agents with Metorial.

  1. How many tools does the Bubble Plan MCP server have?
    The Bubble Plan MCP server exposes 32 tools, including List Subtasks, List Time Entries, List Contacts. Each one is governed and traced through Metorial.
  2. Bubble Plan exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Bubble Plan MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Bubble Plan and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Bubble Plan MCP server yourself or use the hosted gateway.

Connect Bubble Plan to production AI agents

See how Metorial gives your team governed access to Bubble Plan, with tracing and security controls built in.

Book a demoDeploy Bubble Plan