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.

Related MCP server: super-productivity-mcp

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

Projects

Smart Actions

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