# Todo MCP

> Todo MCP is an open-source MCP server for productivity. Shared local-first todo backlog that Claude Code, Cursor, Codex and other MCP hosts can. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web, macOS, Windows, Linux, self-hosted, API
- **Repository:** https://github.com/pasichdev/todo-mcp
- **MCP Registry name:** io.github.pasichDev/todo-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add todo-mcp -- npx -y @pasichdev/todo-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "todo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasichdev/todo-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "todo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasichdev/todo-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "todo-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pasichdev/todo-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "todo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasichdev/todo-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "todo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasichdev/todo-mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Rhizome MCP](https://ai-powered.com/mcp/rhizome-mcp): Rhizome MCP is an open-source MCP server for developer tools.
- [Mewboard](https://ai-powered.com/mcp/mewboard): Mewboard is a paid MCP server for productivity.
- [Dispatch](https://ai-powered.com/mcp/dispatch): Dispatch is a freemium MCP server for developer tools.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [MCP Microsoft Todo](https://ai-powered.com/mcp/mcp-microsoft-todo): MCP Microsoft Todo is an open-source MCP server for productivity.
- [Taskade MCP](https://ai-powered.com/mcp/taskade-mcp): Taskade MCP is a freemium MCP server for productivity.
- [TableThis](https://ai-powered.com/mcp/tablethis): TableThis is a freemium MCP server for productivity.
- [Microsoft Todo MCP Server](https://ai-powered.com/mcp/microsoft-todo-mcp-server): Microsoft Todo MCP Server is an open-source MCP server for productivity.

---
Source: https://ai-powered.com/mcp/todo-mcp-2
