How do I use Super Productivity MCP Server?

1. Click on "Deploy 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., "@Super Productivity MCP Server What tasks are due today?" 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.

de en es ja ko ru zh

Super Productivity MCP Server

by claus-92

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

Super Productivity — MCP Server

Integrates Claude with Super Productivity using the Model Context Protocol. This server targets the desktop app's Local REST API on http://127.0.0.1:3876.

Only tested on macOS. Contributions and bug reports are welcome!

Structure

src/
├── index.ts          ← entry point, starts the MCP server
├── sp-client.ts      ← wrapper for Super Productivity REST API
├── resources.ts      ← resources readable by Claude (tasks, projects, tags)
├── prompts.ts        ← reusable prompt templates
└── tools/
    ├── tasks.ts      ← CRUD tools for tasks
    └── projects.ts   ← tools for projects and tags

Related MCP server: lifeup-mcp

Setup

1. Install dependencies

npm install

2. Build

npm run build
# or use watch mode during development:
npm run dev

3. Enable the API in Super Productivity

In Super Productivity → Settings → Misc → Enable local REST API. The desktop app listens on 127.0.0.1:3876.

4. Register in Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add the block from claude_desktop_config.snippet.json, replacing /ABSOLUTE/PATH/ with the real project path:

{
  "mcpServers": {
    "super-productivity": {
      "command": "/usr/local/bin/node",
      "args": ["/absolute/path/super-productivity-mcp/dist/index.js"],
      "env": {
        "SP_API_URL": "http://127.0.0.1:3876"
      }
    }
  }
}

Restart Claude Desktop. You should see the 🔧 icon in chat — this means the tools are active.

4a. Quick smoke test

Before opening Claude, verify the local API:

curl http://127.0.0.1:3876/health
curl http://127.0.0.1:3876/tasks

5. (Optional) Debug with MCP Inspector

npm run inspect

This opens a web interface for manually testing each tool.

Available Tools

Tool	Description
`health_check`	Checks that the local REST API is up and ready
`list_tasks`	Lists tasks with optional filters (`query`, `projectId`, `projectName`, `tagId`, `tagName`, `includeDone`, `source`)
`search_tasks`	Searches tasks by title text with the same optional filters
`get_task`	Retrieves the details of a single task
`get_status`	Returns current status: active task and task counts
`get_current_task`	Returns the currently running task
`create_task`	Creates a new task; accepts `projectName` and `tagNames` in addition to IDs
`update_task`	Updates fields of an existing task; also supports `projectName` and `tagNames`
`complete_task`	Marks a task as completed
`start_task`	Starts a task as the current task
`set_current_task`	Sets or clears the current task
`stop_current_task`	Stops the current task
`archive_task`	Archives a task
`restore_task`	Restores an archived task
`delete_task`	Deletes a task
`get_projects`	Lists projects
`get_tags`	Lists tags

Available Resources

URI	Description
`sp://status`	Current status in text format
`sp://tasks/active`	Active tasks in text format
`sp://tasks/archived`	Archived tasks in text format
`sp://task/current`	Current task in JSON
`sp://projects`	All projects in JSON
`sp://tags`	All tags in JSON

Available Prompts

Name	Description
`daily-planning`	Daily planning session
`weekly-review`	Weekly review
`break-down-task`	Breaks down a complex task into subtasks

Environment Variables

Variable	Default	Description
`SP_API_URL`	`http://127.0.0.1:3876`	Base URL for the Super Productivity API

Development

npm test

This runs the TypeScript build and the Node test suite.

Available Tools

17 tools

archive_taskC

Archives a task.

Inputs: id (required).

complete_taskC

Marks a task as done.

Inputs: id (required).

create_taskB

Creates a new task in Super Productivity. Extra fields are passed through to the local API if supported by your app version.

Inputs: title (required), notes, projectId, projectName, +4 more.

delete_taskA

Permanently deletes a task.

Inputs: id (required).

get_current_taskA

Returns the currently active task, if any.

Inputs: no named parameters.

get_projectsB

Returns all projects in Super Productivity.

Inputs: query.

get_statusB

Returns the current task and task-count status.

Inputs: no named parameters.

get_tagsB

Returns all tags in Super Productivity.

Inputs: query.

get_taskB

Returns details of a specific task by ID.

Inputs: id (required).

health_checkA

Checks whether the Super Productivity local REST API is reachable and the renderer is ready.

Inputs: no named parameters.

list_tasksC

Returns tasks from Super Productivity with optional filters.

Inputs: query, projectId, projectName, tagId, +3 more.

restore_taskB

Restores an archived task.

Inputs: id (required).

search_tasksB

Searches tasks by title text and optional filters.

Inputs: query (required), projectId, projectName, tagId, +3 more.

set_current_taskA

Sets the current task explicitly, or clears it when id is null.

Inputs: id (required).

start_taskC

Starts the specified task and makes it the current task.

Inputs: id (required).

stop_current_taskB

Stops tracking the current task.

Inputs: no named parameters.

update_taskC

Updates one or more fields of an existing task.

Inputs: id (required), title, notes, projectId, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored 2026-04-27 03:15 across 17 tools

Disambiguation5/5

Each tool has a clearly distinct purpose. For example, start_task begins tracking, set_current_task just assigns the current task, and get_current_task retrieves it. No two tools have ambiguous boundaries.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern in snake_case (e.g., archive_task, complete_task, get_projects). The only slight deviation is health_check, but it is still clearly readable and fits the pattern.

Tool Count5/5

With 17 tools, the server is well-scoped for a task management system. Each tool covers a necessary operation without being excessive or too few.

Completeness5/5

The tool set covers the full CRUD lifecycle for tasks (create, read, update, delete), plus lifecycle operations (start, stop, complete, archive, restore) and status queries. Project and tag retrieval are included, leaving no obvious gaps for the intended domain.

Maintenance

ActivityInactive

ResponsivenessLimited data

Resources

Related MCP Connectors

Redbooth
com.redbooth
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Project Management Workplace & Productivity
1
https://redbooth.com/api/mcp
TimeUno
io.timeuno
Read your tracked time and projects, pause tracking or add a note, from Claude or ChatGPT.
Project Management Workplace & Productivity
1
https://app.timeuno.io/mcp
Superlist
io.github.superlistapp
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Project Management Workplace & Productivity
2
https://app.superlist.com/mcp
ulup-spaces-mcp
com.ulupspaces.www
Create projects, nodes, and tasks in UluP Spaces by conversation with Claude.
Project Management Workplace & Productivity
1
https://www.ulupspaces.com/api/mcp

Related MCP Servers

SP-MCP
organicmoron
A
license
Not graded
quality
D
maintenance
Bridge between Super Productivity app and MCP servers, allowing Claude Desktop to directly interact with Super Productivity for task management, project organization, and information retrieval.
Updated a year ago (2025-07-15 18:45 UTC)
130
MIT
lifeup-mcp
Project Management Games & Gamification
derekprovance
A
license
A
quality
D
maintenance
Enables Claude to interact with LifeUp Cloud API on your local network for task management, achievements, and user information. Supports 20 tools including creating, editing, and querying tasks, achievements, and shop items.
Updated 6 months ago (2026-05-23 18:36 UTC)
6
26
10
MIT
project-manager
Project Management Developer Tools
samrullo
F
license
C
quality
D
maintenance
Connects Claude to a local project management API, enabling task, project, and user management through natural language.
Updated 4 months ago (2026-07-14 07:23 UTC)
46
-
super-productivity-mcp
Project Management Workplace & Productivity
kailasas-auspicious
A
license
B
quality
D
maintenance
Enables interaction with Super Productivity's local REST API to manage tasks, projects, and time tracking through natural language.
Updated 4 months ago (2026-07-14 13:03 UTC)
15
264 npm
MIT

Super Productivity — MCP Server

Structure

Setup

1. Install dependencies

2. Build

3. Enable the API in Super Productivity

4. Register in Claude Desktop

4a. Quick smoke test

5. (Optional) Debug with MCP Inspector

Available Tools

Available Resources

Available Prompts

Environment Variables

Development

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

SP-MCP

lifeup-mcp

project-manager

super-productivity-mcp