Skip to content
MCP server

Todo MCP

Shared local-first todo backlog that Claude Code, Cursor, Codex and other MCP hosts can

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "todo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasichdev/todo-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "todo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasichdev/todo-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers