Super Productivity MCP

# Super Productivity MCP [](https://github.com/rochadelon/super-productivity-mcp/actions) [](https://www.npmjs.com/package/super_produc_mcp) [](LICENSE) 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 ```bash 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](docs/CONFIGURACAO_SERVIDOR.md) for detailed instructions. Example configuration for Claude Desktop (`claude_desktop_config.json`): ```json { "mcpServers": { "super-productivity": { "command": "node", "args": ["C:\\path\\to\\super-productivity-mcp\\dist\\index.js"] } } } ``` ## Configuration Create a `.env` file and add: ```env 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 ```bash npm run dev ``` ## Docker ```bash docker build -t super-productivity-mcp . docker run -p 3000:3000 super-productivity-mcp ``` ## Documentation - [User Guide](docs/GUIA_USO.md) — End-user instructions (Portuguese) - [Server Configuration](docs/CONFIGURACAO_SERVIDOR.md) — How to add it to MCP clients (Portuguese) - [Developer Docs](docs/DESENVOLVIMENTO.md) — For core contributors (Portuguese) ## Contact Connect with the author on LinkedIn: [Delon Rocha](https://www.linkedin.com/in/delonrocha/) ## 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