What You Can Do

✅ Quick Capture

"Add a task: Buy milk #shopping @tomorrow 15m"

Parses the tag, due date, and time estimate from short syntax — one shot, no follow-up needed.

🧹 Batch Triage

"Show me all unscheduled tasks in my Work project, tag them #backlog, and set them due next Friday"

Filters, bulk-updates due dates, and adds tags — all in one conversation turn.

🧠 Full Planning Session

"Look at my week: show today's plan and anything overdue. Break 'Launch blog' into subtasks, start the first one, and move anything I finished yesterday to done. Give me a time summary when you're done."

Reads resources for context, creates subtasks in batch, starts the timer, bulk-completes tasks, pulls the worklog, and summarizes — a multi-step workflow in a single prompt.

→ More use cases

Installation

1. Install the SP Plugin

Option A — via npx:

npx -y super-productivity-mcp@latest --extract-plugin

Option B — manual download: Download plugin.zip from the latest release.

Then in Super Productivity: Settings → Plugins → Upload Plugin, select plugin.zip, restart SP.

2. Configure Your MCP Client

{
  "mcpServers": {
    "super-productivity": {
      "command": "npx",
      "args": ["-y", "super-productivity-mcp"]
    }
  }
}

Config file locations:

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json

3. Verify

Ask your AI assistant: "Check the Super Productivity connection"

Prerequisites

• Super Productivity >= 14.0.0
• Node.js >= 18
• An MCP-compatible client (Claude Desktop, Kiro, etc.)

Available Tools

| Tool | Description | |------|-------------| | create_task | Create a task (supports SP short syntax) | | create_task_with_subtasks | Create a parent task + subtasks in one operation | | get_tasks | List tasks — filter by project, tag, done, archived, search (title+notes), parents_only, overdue, unscheduled, planned_for_today, recurring_only, fields | | update_task | Update title, notes, done state, due date, planned_at, time, tags | | complete_task | Mark a task as complete | | delete_task | Permanently delete a task (parent deletes subtasks too) | | start_task | Start the time tracker on a task | | stop_task | Stop the currently running time tracker | | get_current_task | Get the currently tracked task (null if none) | | plan_tasks_for_today | Batch plan/unplan tasks for today ⚠️ limited | | bulk_complete_tasks | Mark multiple tasks complete in one operation | | bulk_update_tasks | Update multiple tasks in one operation | | add_tag_to_task | Add a tag without replacing other tags | | remove_tag_from_task | Remove a single tag | | move_task_to_project | Move a top-level task to a different project | | reorder_tasks | Reorder tasks within a project or parent | | get_projects | List all projects | | create_project | Create a new project | | update_project | Update project properties | | get_tags | List all tags | | create_tag | Create a new tag | | update_tag | Update tag properties | | get_worklog | Time tracking summary for a date range | | show_notification | Show a snackbar in SP's UI | | check_connection | Verify SP is running and the plugin is responding | | debug_directories | Show resolved data directory paths |

SP Short Syntax

Include these in task titles and they are parsed automatically:

| Syntax | Example | Effect | |--------|---------|--------| | #tag | Buy milk #shopping | Adds the "shopping" tag | | +project | Fix bug +work | Assigns to "work" project (prefix match, min 3 chars) | | @due | Report @friday | Sets due date to Friday | | @due time | Call @tomorrow 3pm | Sets due date and time | | 30m | Quick fix 30m | Sets 30-minute time estimate | | 1h/2h | Research 1h/2h | Sets 1h spent, 2h estimate |

Troubleshooting

Plugin not loading? Update to SP ≥ 18.6.0 — older versions have a cold-boot race that can prevent the plugin from initializing. On SP ≥ 18.6.0 this is fixed and no restart is needed; just toggle the plugin off and on in Settings → Plugins. On older versions, a restart after toggling may help.

Commands timing out? Ask "Show debug info for Super Productivity" to check that both sides are using the same data directory. Mac App Store users may need to set SP_MCP_DATA_DIR.

→ Full troubleshooting guide

Known Limitations

| Tool | Issue | Status | |------|-------|--------| | plan_tasks_for_today | Sets plannedAt on the task but does not add it to SP's internal Planner store, so the task may not appear in the Today view. | Upstream request: super-productivity#7495 |

License

MIT