todo-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@todo-mcpadd a task to buy groceries"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Tool | Description |
| Add a new item ( |
| List items, optional |
| Mark an item done/undone ( |
| Delete an item ( |
| Remove all completed items |
Related MCP server: Task Manager MCP Server
Setup
npm install
npm run buildThis 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.jsClaude 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 --watchThis server cannot be deployed
Related MCP Connectors
Create, list, and complete todo items through MCP.
Todo app that keeps a record: list, add, start and complete todos, and get a weekly summary.
Add items to your tidee workspace from ordinary language, read what is there, and mark things done.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables users to manage a persistent todo list through natural language, supporting adding, listing, toggling completion status, and removing todos. Features both stdio and HTTP transports with optional authentication and JSON file storage.4-
- FlicenseNot gradedqualityDmaintenanceEnables task management through natural language with full CRUD operations including add, list, update, complete, and delete tasks with JSON persistence.-
- AlicenseAqualityDmaintenanceA task management and productivity tool that enables creating, updating, filtering, and organizing todos with tags, priorities, and due dates, all stored locally in JSON format.77 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage a todo list with add, list, complete, and delete tasks.49 npmMIT