Super Productivity MCP

Build Status npm version 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

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Super Productivity MCP

Super Productivity MCP

About

Architecture

Requirements

Quick Start

1. Run the MCP Server

2. Super Productivity Plugin

3. Configure an MCP Client

Configuration

Available Tools

Tasks

Projects

Smart Actions

Project Structure

Development

Docker

Documentation

Contact

Verify the Installation

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API