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.zipfile - 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