Super Productivity

You run a dedicated MCP server that lets AI assistants manage tasks, projects, and productivity analytics inside Super Productivity. It exposes a set of tools you can call from an assistant, connects locally via a simple start command, and runs on a configurable port for secure, contained access.

How to use

You use an MCP client to connect to the server and request actions such as listing or creating tasks and projects, analyzing productivity, or creating a daily plan. The server exposes tools across tasks, projects, and smart actions that you can invoke from your AI assistant. Start the server, configure the MCP client, and then issue the actions you need; the client will handle the rest.

How to install

Prerequisites you must have before installing: Node.js 18 or newer and Super Productivity v14.0.0 or newer.

Prepare the project directory and install dependencies, then build and start the server using the following steps.

node -v
npm -v

# Ensure you have the project files in a folder named 'super-productivity-mcp' depending on your setup.

cd super-productivity-mcp
npm install
npm run build
npm start

Configure the MCP client and runtime

Configure your MCP client so it can reach the local server. The server runs on a configurable port and exposes the runtime over an HTTP/stdio bridge. The server can be started as shown above and listens on port 3000 by default.

# Example: Claude Desktop configuration (illustrative)
{
  "mcpServers": {
    "super-productivity": {
      "command": "node",
      "args": ["dist/index.js"]
    }
  }
}

Available tools

list_tasks

List tasks in Super Productivity via the MCP bridge.

create_task

Create a new task with specified details via the MCP bridge.

update_task

Update an existing task's fields through the MCP bridge.

complete_task

Mark a task as completed via the MCP bridge.

batch_update_tasks

Apply batch operations to multiple tasks.

list_projects

List projects in Super Productivity via the MCP bridge.

create_project

Create a new project via the MCP bridge.

analyze_productivity

Produce a productivity analysis from your task and work data.

suggest_priorities

Suggest priorities based on current tasks and plans.

create_daily_plan

Generate a daily work plan from your tasks and priorities.