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
Maintenance
Related MCP Connectors
Create, list, and complete todo items through MCP.
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.
A todo and task board in kanban form, driven from chat with full CRUD.
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.73 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage a todo list with add, list, complete, and delete tasks.47 npmMIT