MCP server

Plug Choreographd into your favorite AI agent.

Connect Cursor, Claude, or any MCP-compatible client to add tasks, update scopes, and manage weekly goals — without leaving your editor.

Get started with Agents Get API key

Tools

Everything your agent needs

Stable, authenticated JSON-RPC tools that mirror the actions you can perform in the Choreographd UI.

add_task
Create a new task inside a scope with full control over impact, effort, priority, and weekly goal links.
edit_task
Partially update any user-editable task field, including progress and archive state.
complete_task
Mark a task as complete (or reopen it) with a single call.
add_weekly_goal
Create a weekly goal with a title, summary, and color. Hard-limited to 3 active goals.
list_tasks
List every task across scopes, with filters for archived and completed items.
list_weekly_goals
List every active and archived weekly goal.
list_scopes
List every scope (context) owned by the caller. Returns IDs for use with other tools.
list_tasks_in_scope
List tasks scoped to a specific context.

Configure your client

Copy, paste, go.

Pick your client, copy the matching snippet, and replace YOUR_API_KEY with the key from your preferences page.

Paste this into your Cursor MCP settings, then replace YOUR_API_KEY.

{
  "mcpServers": {
    "choreographd": {
      "url": "https://choreographd.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}