Sp MCP

🚀 SP-MCP

A bridge between the amazing Super Productivity app and MCP (Model Context Protocol) servers for Claude Desktop integration.

This MCP and plugin enable Claude Desktop to directly interact with Super Productivity via the MCP protocol. You can create and update tasks, manage projects and tags, and retrieve information from Super Productivity.

⚠️ Important Note

Make sure to backup your Super Productivity data before use to prevent data loss. A plugin.zip is provided for convenience, but you can create your own from the files.

(Currently, tasks cannot be deleted, but they can be marked as done.)

🚀 Quick Start

Demo

Check out the demo here: Demo Link

Requirements

• Super Productivity 14.0.0 or higher
• Claude Desktop
• Python 3.8 or higher

📦 Installation

Automatic Setup

Windows:

1. Clone this repository.
2. Run setup.bat.
3. Follow the prompts.

Linux/Mac (UNTESTED):

1. Clone this repository.
2. Run chmod +x setup.sh && ./setup.sh.
3. Follow the prompts.

The setup scripts will preserve any existing MCP servers in your Claude Desktop configuration.

You still need to manually install the plugin.zip in Super Productivity under settings -> plugins.

After that, restart Claude (and Super Productivity for safety) and you should be able to access your files.

Manual Setup

1. Install Python dependencies:

   pip install mcp
   

2. Set up MCP server: Copy mcp_server.py to your data directory:

   • Windows: %APPDATA%\super-productivity-mcp\
   • Linux: ~/.local/share/super-productivity-mcp/
   • macOS: ~/Library/Application Support/super-productivity-mcp/

3. Configure Claude Desktop: Edit Claude's config file and add to mcpServers:

   "super-productivity": {
     "command": "python3",
     "args": ["/path/to/mcp_server.py"]
   }
   

4. Install the plugin:

   • Open Super Productivity → Settings → Plugins.
   • Click "Upload Plugin".
   • Select plugin.js.

5. Restart Claude Desktop

💻 Usage Examples

Basic Usage

Creating Tasks

"Create a task to review the quarterly budget #finance +work"

Task Management

"Show me all my tasks"
"Mark the budget review task as complete"
"Update the task 'Meeting prep' with notes about the agenda"

Project and Tag Management

"Create a new project called 'Website Redesign'"
"Show me all projects"
"Get all tags"

📚 Documentation

Dashboard

Access the SP - MCP dashboard from the menu. The dashboard shows:

• Real - time statistics
• Connection status
• Activity logs
• Settings (polling frequency: default 2 seconds)

Communication

The plugin uses file - based communication through:

• Windows: %APPDATA%\super-productivity-mcp\
• Linux: ~/.local/share/super-productivity-mcp/
• macOS: ~/Library/Application Support/super-productivity-mcp/

Commands are exchanged through plugin_commands/ and plugin_responses/ directories.

Troubleshooting

Plugin Not Loading

• Check Super Productivity version (14.0.0+ required).
• Verify plugin permissions include nodeExecution.

Commands Not Working

• Verify both plugin and MCP server are running.
• Check file permissions on communication directories.
• Check mcp_server.log in the data directory.