todo-mcp

A simple todo list MCP server written in TypeScript. It exposes tools for managing a todo list to any MCP client (Claude Desktop, Claude Code, etc.). Todos are persisted to a JSON file on disk.

Tools

Related MCP server: Task Manager MCP Server

Setup

npm install
npm run build

This compiles to build/index.js. By default todos are stored in ~/.todo-mcp.json; override with the TODO_FILE environment variable.

Connecting a client

Claude Code

claude mcp add todo -- node /Users/mansi/Documents/MCP/todo-list/build/index.js

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/Users/mansi/Documents/MCP/todo-list/build/index.js"]
    }
  }
}

Restart the client, then ask it to add, list, or complete todos.

Development

npm run dev    # tsc --watch