Todo MCP
Shared local-first todo backlog that Claude Code, Cursor, Codex and other MCP hosts can
- Pricing
- Open source
- Platforms
- CLI, Web, macOS
- Runs
- Locally
- Version
- 2.2.0
- Listing updated
- today
Similar MCP servers
About Todo MCP
Todo MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
The README says Docket is a single backlog that several AI coding tools write into, with items filed automatically under the project they were captured in, resolved from the git remote. A thought raised mid-session can be captured in one sentence and later promoted to an issue or ticket elsewhere, with a sourceUrl linking the two.
It runs as an npm package that an MCP host starts over stdio. In Local Mode state stays on the user's machine in encrypted files, with an optional web dashboard on localhost and optional sync between the user's own devices. A Self-hosted Mode lets several clients share one server, where claims are atomic rather than advisory.
It suits developers who move between several AI agents and projects and want one place for loose work items. The project's own documentation also flags the P2P sync feature as deprecated as of v3.0.
Install
Run in a terminal
claude mcp add todo-mcp -- npx -y @pasichdev/todo-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"todo-mcp": {
"command": "npx",
"args": [
"-y",
"@pasichdev/todo-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"todo-mcp": {
"command": "npx",
"args": [
"-y",
"@pasichdev/todo-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"todo-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pasichdev/todo-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"todo-mcp": {
"command": "npx",
"args": [
"-y",
"@pasichdev/todo-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"todo-mcp": {
"command": "npx",
"args": [
"-y",
"@pasichdev/todo-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- todo_add
- Capture an item filed under the current project.
- todo_list
- List open items, scoped to the current project by default.
- todo_edit
- Edit fields of an item by id.
- todo_claim
- Mark an item in progress.
- todo_release
- Drop the claim on an item.
- todo_complete
- Mark an item done.
- todo_history
- Show the change log for one item.
- todo_delete
- Permanently remove an item.
- todo_version
- Report the data-format version.
- todo_check_update
- Read-only npm version check.
- digest_publish
- Save a digest compiled by an agent.
- digest_list
- List recent digests.
- digest_get
- Fetch one digest in full.
- digest_delete
- Remove a digest.
- digest_take
- Hand a digest item to the calling agent with a claimed task.
- digest_seen
- List items the user marked seen.
What it does
- Automatic project scoping
- Items are filed under the project resolved from the git remote, so each agent sees only that project's open work by default.
- Shared across agent hosts
- Any MCP host can read and write the same list, including Claude Code, Cursor, Codex, Windsurf and Zed.
- Item claims with expiry
- Agents can mark an item in progress, and the claim expires automatically after 15 minutes.
- Encrypted local storage
- The store and history are AES-256-GCM encrypted with a locally generated key.
- Live web dashboard
- A localhost dashboard updates over Server-Sent Events and includes a workspace switcher and search.
- Digest publishing
- Agents can save digests compiled from connected sources, and digest items can be handed to another agent by number.
Good for
- Capture a passing idea from an agent session without leaving the editor
- Keep a per-project backlog visible to several AI coding tools at once
- Hand a numbered digest item to an agent with a claimed task
- Link local backlog items to GitLab issues, Notion pages or GitHub PRs via sourceUrl
Pricing
Open source
MIT licensed, self-hosted; no paid plan described.
Todo MCP FAQ
Does it need a hosted account?
No. The README says Local Mode runs on the user's machine with no SaaS account, and Self-hosted Mode runs on a server the user controls.
How do I install it?
The README gives the quick start as npx -y @pasichdev/docket setup, which configures the MCP hosts it finds on the machine.
What does Node.js version does it need?
The README lists Node.js 18 or later as a requirement.
Is it free?
The README states the license is MIT. It does not describe any paid plan.
Is Todo MCP free?
Yes. Todo MCP is open source, so you can use and self-host it for free.
How do I add Todo MCP to Claude Code?
Run this command in your terminal: claude mcp add todo-mcp -- npx -y @pasichdev/todo-mcp
What are the best alternatives to Todo MCP?
The closest alternatives to Todo MCP are Rhizome MCP, Mewboard, Dispatch, Concord MCP and MCP Microsoft Todo.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.