SP-MCP
An MCP server and Plugin for the SuperProductivity app!
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/organicmoron--sp-mcp)HTML
<a href="/listings/organicmoron--sp-mcp"><img src="/api/listings/organicmoron--sp-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Automatic Setup
**Windows:** 1. Clone this repo 2. Run `setup.bat` 3. Follow the prompts
**Linux/Mac UNTESTED:** 1. Clone this repo 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'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
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**
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 118 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # SP-MCP
- Bridge between the amazing [Super Productivity](https://github.com/johannesjo/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:**
- 1. Clone this repo
- 2. Run `setup.bat`
- 3. Follow the prompts
- **Linux/Mac UNTESTED:**
- 1. Clone this repo
- 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'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
- 1. **Install Python dependencies:**
- ```bash
- 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`:
- ```json
- "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
- ### 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"
- ```
- ## 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.