Super Productivity MCP

An MCP (Model Context Protocol) server to integrate Super Productivity with AI assistants.

About

This project enables AI assistants (like Claude) to manage tasks, projects, and analyze productivity directly within Super Productivity.

Architecture

Requirements

Node.js 18+
Super Productivity v14.0.0+

Quick Start

1. Run the MCP Server

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

2. Super Productivity Plugin

Open Super Productivity > Settings > Plugins
Install the mcp-bridge-plugin.zip file
Restart the app

3. Configure an MCP Client

See docs/CONFIGURACAO_SERVIDOR.md for detailed instructions.

Example configuration for Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "super-productivity": {
      "command": "node",
      "args": ["C:\\path\\to\\super-productivity-mcp\\dist\\index.js"]
    }
  }
}

Configuration

Create a .env file and add:

PORT=3000

Available Tools

All tools are exposed through the MCP server and can be invoked by AI assistants.

Tasks

Tool	Description
`list_tasks`	List tasks
`create_task`	Create a task
`update_task`	Update a task
`complete_task`	Mark a task as complete
`batch_update_tasks`	Batch operations on tasks

Projects

Tool	Description
`list_projects`	List projects
`create_project`	Create a project

Smart Actions

Tool	Description
`analyze_productivity`	Productivity analysis
`suggest_priorities`	Suggest priorities
`create_daily_plan`	Create a daily work plan

Project Structure

super-productivity-mcp/
├── src/
│   ├── index.ts           # Entry point
│   ├── client/
│   │   └── sp-client.ts   # HTTP client (legacy)
│   └── tools/
│       ├── tasks.ts       # Task tools
│       ├── projects.ts    # Project tools
│       └── smart-actions.ts
├── mcp-bridge-plugin/
│   ├── manifest.json      # Plugin manifest
│   ├── plugin.js          # Plugin code
│   └── socket.io.min.js   # Socket.IO library
├── docs/                  # Documentation
└── package.json

Development

npm run dev

Docker

docker build -t super-productivity-mcp .
docker run -p 3000:3000 super-productivity-mcp

Documentation

User Guide — End-user instructions (Portuguese)
Server Configuration — How to add it to MCP clients (Portuguese)
Developer Docs — For core contributors (Portuguese)

Contact

Connect with the author on LinkedIn: Delon Rocha

Verify the Installation

Start the server: npm start
Open Super Productivity
In the browser console (F12), verify: MCP Bridge: Connected to MCP Server
In the server terminal, verify: Plugin Super Productivity connected

License

ISC

super-productivity-mcp