This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Super Productivity Local Bridge
Control Super Productivity tasks, projects, and tags from MCP hosts, CLI, and local automation tools — all through the desktop app's Local REST API.
Why
Super Productivity is a great task manager. This bridge lets AI coding agents and automation scripts interact with it programmatically — creating tasks, tracking work, and managing projects without leaving your workflow.
The bridge talks only to your local Super Productivity API on 127.0.0.1:3876. Your MCP host may have its own data handling, so review the host's privacy model before granting task access.
Features
- 16 operations — list/get/create/update/complete/uncomplete/start/stop/archive/restore tasks, current task get/set, list projects, list tags, status, health check, plus filters and time fields
- MCP adapter — live-validated with VS Code Copilot; includes setup guides and config generation for Claude Desktop and Codex CLI
- CLI — command-line access to common operations (health, status, list/get/create tasks, current task, projects, tags)
- Host config generator — prints ready-to-paste config with absolute paths for each supported host
- Doctor command — diagnoses connectivity and configuration issues
Install
Requires Python 3.11+ and uv.
git clone https://github.com/CameronBrooks11/super-productivity-local-bridge.git
cd super-productivity-local-bridge
scripts/install.sh
Use --dry-run to preview.
Alternatively, install from a GitHub Release wheel:
uv tool install https://github.com/CameronBrooks11/super-productivity-local-bridge/releases/download/v0.2.0/sp_local_bridge-0.2.0-py3-none-any.whl
Configure an MCP Host
sp-local-bridge-print-config vscode-copilot # VS Code Copilot
sp-local-bridge-print-config claude-desktop # Claude Desktop
sp-local-bridge-print-config codex # Codex CLI
Add the printed snippet to the config file shown in the output, then restart the host.
See the host setup guides for detailed instructions.
Verify
sp-local-bridge-doctor
Safety
This bridge has write access to your Super Productivity data (create, update, complete, archive tasks). It talks only to localhost. task.delete is intentionally excluded. Back up your SP data before heavy automation use.
See Security for the full risk profile.
Documentation
Full docs: cameronbrooks11.github.io/super-productivity-local-bridge
Development
uv sync # Install deps
make check # Format, lint, typecheck, test, build
uv run pytest --cov # Tests with coverage
uv run pre-commit install # Git hooks
License
1 maintainer
Metadata
1 maintainer
Release files for sp-local-bridge 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| sp_local_bridge-0.2.2.tar.gz | 143.2 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sp_local_bridge-0.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 169.7 kB
Release files / sp_local_bridge-0.2.2.tar.gz
| Download URL | sp_local_bridge-0.2.2.tar.gz |
|---|---|
| Size | 143.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
088dac6561787cfac3b0b651cdd29cd2e777363d2214b6617f41caa567ff4844
|
|
BLAKE2b-256 checksum How to use checksums |
a121d11c435c7dfb887b37e02ae95e928ea62500970835b08882911c8cf3ccdb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 5, 2026.
Transparency logRelease files / sp_local_bridge-0.2.2-py3-none-any.whl
| Download URL | sp_local_bridge-0.2.2-py3-none-any.whl |
|---|---|
| Size | 26.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ad64150a965f007083a9b9d9ac835153d11d10c52ab56949b14eb1f0aa4b4d67
|
|
BLAKE2b-256 checksum How to use checksums |
c4b5476c65017d6a31181eccc93b26c89680566335602d2591a8d08c13a66de3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 5, 2026.
Transparency logSecurity for sp-local-bridge 0.2.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for sp_local_bridge-0.2.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 5, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
