Reference

MCP Tool Catalog

Every tool the MCPlan MCP server exposes — 27 in total. Tools marked read only read your data; tools marked write mutate it. Generate a key in Settings → API keys and grant only the scopes you need.

Set up MCPlan as an MCP server in your client (Claude Desktop, Claude Code, Cursor, etc.) by following the connection guide.

Account

Quota and billing-aware metadata.

  • get_quotaread

    Returns the caller's MCP action quota for the current month: plan, actions used, monthly cap (team caps are pooled across the org's seats), remaining actions, and the UTC reset timestamp.

Projects

Containers for tasks. Required scope `projects:write` for mutating calls.

  • list_projectsread

    List all active projects for the authenticated user, including active task counts.

  • create_projectwrite

    Create a new project for the authenticated user.

  • update_projectwrite

    Update an existing project. Only provided fields will be updated.

  • delete_projectwrite

    Delete a project and all its tasks.

Sections

Logical groupings within a project.

  • list_sectionsread

    List all sections in a project.

  • create_sectionwrite

    Create a new section in a project.

  • update_sectionwrite

    Rename a section in a project or update its description.

  • delete_sectionwrite

    Delete a section from a project. Tasks in this section become unassigned.

Tasks

The bulk of the MCP surface. Required scope `tasks:write` for mutating calls.

  • list_tasksread

    List tasks in a project with optional filters.

  • list_my_tasksread

    List the caller's tasks across projects, scoped by a named view: `inbox`, `today`, `upcoming`, or `overdue`.

  • search_tasksread

    Search across all active tasks for the authenticated user.

  • create_taskwrite

    Create a new task in a project.

  • update_taskwrite

    Update an existing task. Only provided fields will be updated.

  • complete_taskwrite

    Mark a task as completed.

  • delete_taskwrite

    Delete a task and all its subtasks.

  • read_task_attachmentsread

    Read image attachments on a task. Returns each image inline as an MCP image content block plus a text header. Non-image attachments are listed as text only.

  • attach_image_to_taskwrite

    Attach an image to a task. Accepts base64-encoded image data — useful when dropping an image into Claude and wanting to save it on a task.

  • claim_taskwrite

    Claim a task to prevent parallel MCP work. Locks for 24 hours and auto-extends on each owner-key call. Web UI writes are not affected.

  • release_taskwrite

    Release a task lock previously acquired via claim_task. Only the lock holder can release.

Labels

Tags applied to tasks. Required scope `labels:write` for mutating calls.

  • list_labelsread

    List all labels for the authenticated user.

  • create_labelwrite

    Create a new label.

  • update_labelwrite

    Update an existing label (rename or recolor).

  • delete_labelwrite

    Delete a label. Removes it from all tasks and API keys.

Plans (markdown round-trip)

Import and export markdown plan documents — the round-trippable format MCPlan was built around.

  • import_planwrite

    Import a markdown plan document as a new project with sections and tasks in Firestore.

  • export_planread

    Export a project as a markdown plan document.

Organizations

Team-context helpers. Org/team features are coming in a future release.

  • list_org_membersread

    List members of an organization, optionally filtered by team.