SP-MCP
Bridge between the amazing Super Productivity app and MCP (Model Context Protocol) servers for Claude Desktop integration.
This MCP and plugin allows Claude Desktop to directly interact with Super Productivity through the MCP protocol. Create update,tasks, manage projects and tags, and get information from Super Productivity.
Make sure to backup your Super Productivity before using in case of data loss. I've provided a plugin.zip for convenience but feel free to make your own from the files.
(Can't delete tasks right now (but it can mark them as done))
Demo
https://github.com/user-attachments/assets/cc118173-023f-48cb-8213-427027e475af
Requirements
- Super Productivity 14.0.0 or higher
- Claude Desktop
- Python 3.8 or higher
Installation
Automatic Setup
Windows:
- Clone this repo
- Run
setup.bat
- Follow the prompts
Linux/Mac UNTESTED:
- Clone this repo
- Run
chmod +x setup.sh && ./setup.sh
- Follow the prompts
The setup scripts will preserve any existing MCP servers in your Claude Desktop configuration.
You'll still have to install the plugin.zip manually in Super Productivity in settings->plugins.
Once that's done, restart claude (and Super Prod for good measure) and you should be able to access your files
Manual Setup
- Install Python dependencies:
- 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/
- Windows:
- Configure Claude Desktop:
Edit Claude's config file and add to
mcpServers
: - Install the plugin:
- Open Super Productivity → Settings → Plugins
- Click "Upload Plugin"
- Select
plugin.js
- Restart Claude Desktop
Usage
Creating Tasks
Task Management
Project and Tag Management
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
This server cannot be installed
Bridge between Super Productivity app and MCP servers, allowing Claude Desktop to directly interact with Super Productivity for task management, project organization, and information retrieval.
Related MCP Servers
- AsecurityAlicenseAqualityAllows Claude desktop app to execute terminal commands and edit files on your computer through MCP, with features including command execution, process management, and diff-based file editing.Last updated -2129,5864,395MIT License
- AsecurityFlicenseAqualityA server built on mcp-framework that enables integration with Claude Desktop through the Model Context Protocol.Last updated -11
- -securityAlicense-qualityAn MCP server that allows Claude models to use Union tasks, workflows, and apps as tools in conversations.Last updated -5Apache 2.0
- AsecurityFlicenseAqualityA server built with mcp-framework that allows users to extend Claude's capabilities by adding custom tools that can be used through the Claude Desktop client.Last updated -374