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

1. Open Super Productivity > Settings > Plugins
2. Install the mcp-bridge-plugin.zip file
3. 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

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

License

ISC