Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/organicmoron--sp-mcp/badge.svg)](/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

i

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)

  1. # SP-MCP
  2. Bridge between the amazing [Super Productivity](https://github.com/johannesjo/super-productivity/) app and MCP (Model Context Protocol) servers for Claude Desktop integration.
  3. 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.
  4. 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.
  5. (Can't delete tasks right now (but it can mark them as done))
  6. ## Demo
  7. https://github.com/user-attachments/assets/cc118173-023f-48cb-8213-427027e475af
  8. ## Requirements
  9. - Super Productivity 14.0.0 or higher
  10. - Claude Desktop
  11. - Python 3.8 or higher
  12. ## Installation
  13. ### Automatic Setup
  14. **Windows:**
  15. 1. Clone this repo
  16. 2. Run `setup.bat`
  17. 3. Follow the prompts
  18. **Linux/Mac UNTESTED:**
  19. 1. Clone this repo
  20. 2. Run `chmod +x setup.sh && ./setup.sh`
  21. 3. Follow the prompts
  22. The setup scripts will preserve any existing MCP servers in your Claude Desktop configuration.
  23. You'll still have to install the plugin.zip manually in Super Productivity in settings->plugins.
  24. Once that's done, restart claude (and Super Prod for good measure) and you should be able to access your files
  25. ### Manual Setup
  26. 1. **Install Python dependencies:**
  27. ```bash
  28. pip install mcp
  29. ```
  30. 2. **Set up MCP server:**
  31. Copy `mcp_server.py` to your data directory:
  32. - Windows: `%APPDATA%\super-productivity-mcp\`
  33. - Linux: `~/.local/share/super-productivity-mcp/`
  34. - macOS: `~/Library/Application Support/super-productivity-mcp/`
  35. 3. **Configure Claude Desktop:**
  36. Edit Claude's config file and add to `mcpServers`:
  37. ```json
  38. "super-productivity": {
  39. "command": "python3",
  40. "args": ["/path/to/mcp_server.py"]
  41. }
  42. ```
  43. 4. **Install the plugin:**
  44. - Open Super Productivity → Settings → Plugins
  45. - Click "Upload Plugin"
  46. - Select `plugin.js`
  47. 5. **Restart Claude Desktop**
  48. ## Usage
  49. ### Creating Tasks
  50. ```
  51. "Create a task to review the quarterly budget #finance +work"
  52. ```
  53. ### Task Management
  54. ```
  55. "Show me all my tasks"
  56. "Mark the budget review task as complete"
  57. "Update the task 'Meeting prep' with notes about the agenda"
  58. ```
  59. ### Project and Tag Management
  60. ```
  61. "Create a new project called 'Website Redesign'"
  62. "Show me all projects"
  63. "Get all tags"
  64. ```
  65. ## Dashboard
  66. Access the SP-MCP dashboard from the menu. The dashboard shows:
  67. - Real-time statistics
  68. - Connection status
  69. - Activity logs
  70. - Settings (polling frequency: default 2 seconds)
  71. ## Communication
  72. The plugin uses file-based communication through:
  73. - Windows: `%APPDATA%\super-productivity-mcp\`
  74. - Linux: `~/.local/share/super-productivity-mcp/`
  75. - macOS: `~/Library/Application Support/super-productivity-mcp/`
  76. Commands are exchanged through `plugin_commands/` and `plugin_responses/` directories.
  77. ## Troubleshooting
  78. ### Plugin Not Loading
  79. - Check Super Productivity version (14.0.0+ required)
  80. - Verify plugin permissions include `nodeExecution`
  81. ### Commands Not Working
  82. - Verify both plugin and MCP server are running
  83. - Check file permissions on communication directories
  84. - Check `mcp_server.log` in the data directory

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.