OS

organicmoron/sp-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

129 stars 30 forks 품질 64 트렌드 16MIT

organicmoron/sp-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

organicmoron/sp-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

놀라운 Super Productivity 앱과 MCP(Model Context Protocol) 서버 간의 브리지 역할을 하여 Claude Desktop 통합을 지원합니다.

이 MCP와 플러그인은 Claude Desktop이 MCP 프로토콜을 통해 Super Productivity와 직접 상호작용할 수 있게 합니다. 업데이트, 작업 생성, 프로젝트 및 태그 관리, 슈퍼 생산성 정보 획득.

데이터 손실 시 대비해 사용 전에 슈퍼 프로덕티시티브 백업을 꼭 하세요. 편의를 위해 plugin.zip을 제공했지만, 파일로 직접 만들어도 좋습니다.

(지금은 작업을 삭제할 수 없지만 완료 표시는 할 수 있습니다)

데모

https://github.com/user-attachments/assets/cc118173-023f-48cb-8213-427027e475af

요구 사항

  • 슈퍼 생산성 14.0.0 이상
  • 클로드 데스크톱
  • Python 3.8 이상

설치

자동 설정

윈도우:

  1. 이 저장소를 복제해
  2. 달리기 setup.bat
  3. 프롬프트를 따라

Linux/Mac 미테스트 데이터:

  1. 이 저장소를 복제해
  2. 달리기 chmod +x setup.sh && ./setup.sh
  3. 프롬프트를 따라

설정 스크립트는 Claude Desktop 설정에 있는 기존 MCP 서버를 모두 보존합니다.

그래도 설정->플러그인의 Super Productivity에서 수동으로 plugin.zip을 설치해야 합니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

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:

  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

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

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →