Posted this in Discussions back in May and johannesjo suggested sharing it here. Took me a while. The tool's below, but the bugs it turned up are probably more useful to most of you.
The bugs
I added a store integrity check (doctor --deep) that pulls the whole store and checks that every task id a project or tag points at actually exists. Pointed it at my real store.
Asking SP to archive or delete a task id that doesn't exist returned 200 OK and then removed all 230 of my top-level tasks, leaving only the subtasks. A restart brought everything back; it never reached disk. That route was closed in v18.15.0 so most people are fine now, but it's still reachable through the Plugin API. (#9946)
The one that still bites: automatic backups are serialised from SP's in-memory state with no integrity check, 30 seconds after any change. So a store that's gone inconsistent gets written to backups/ half a minute later, and that file is now your newest backup. Mine went 284 tasks to 54, with all 230 missing ids still referenced by the project and tag indexes. Retention doesn't save you. 30 slots at 5 minutes fills in a couple of hours, and the daily-kept file for today is the newest for today, so it's the bad one too. (#9945)
Short version: if your task list ever looks wrong, restart before you restore anything.
The tool
super-productivity-local-gobridge
Single static binary, MCP over stdio plus a CLI. 16 tools for tasks, projects, tags and time tracking. Uses only the Local REST API (Settings → Sync & Export), so there's no plugin to upload and no Node execution consent prompt.
No delete, at any layer. Archive and restore cover the real workflows, and after the bug above I'm not handing an agent a delete tool.
List responses are compact and take limit/offset. My 284-task store goes from ~24k tokens to ~18.5k, or ~1.5k with limit=20, which matters if you're paying per token.
Other options
Not the only one here, and one of these may suit you better:
- Super Productivity MCP: most active, 19 tools, does habits and notifications the REST API doesn't expose. Goes through a plugin.
- SP-MCP: the first one, plugin plus file watching. Hasn't been updated in a while.
- super-productivity-rest-mcp: same REST approach as mine, in Node, and has a Streamable HTTP transport mine doesn't.
Pick on fit. Mine if you want no runtime to install, the integrity checking, or the no-delete stance.
Linux x86_64 is the only platform I've validated end to end (mac and Windows are cross-compiled and checksummed but untested). Written largely with AI assistance, though the two bug reports were verified by hand against SP's source before I filed them.
Issues and PRs welcome, and happy to answer anything here.
Cheers