mcp-todo

mcp-todo is an MCP server that provides task tracking and to-do list management directly within Model Context Protocol clients like Claude. It connects local AI assistants to an underlying task storage system, allowing users to organize daily objectives without leaving their conversation interface. Geared toward developers, knowledge workers, and productivity-focused users, the server enables automated task creation, categorization, and updates. Users can direct their AI assistant to record incoming to-do items, inspect pending assignments, categorize work by topic, and mark completed jobs. By externalizing task state through environment-configured cache directories, mcp-todo lets conversational agents maintain context about user workloads across sessions, turning natural language prompts into organized, actionable task records.

Category: Project & Task Management

Tags: productivity, tasks, todo, tracking

Visit mcp-todo

How to install and configure mcp-todo

1. Clone the repository and install dependencies using Rye by running rye sync in your project root. 2. Locate the virtual environment Python binary at /your/path/.venv/bin/python3 and the script entry point at /your/path/src/run.py. 3. Open your Claude Desktop configuration file and add the server definition under mcpServers: json { "mcpServers": { "mcp-todo": { "command": "/your/path/.venv/bin/python3", "args": [ "/your/path/src/run.py" ], "env": { "MCP_TODO_CACHE_DIR": "/your/path/cache_data" } } } } 4. Replace placeholder paths with your actual project directory and desired cache path, then restart Claude Desktop.

What you can do with mcp-todo

• Creating new to-do items from chat prompts to log daily developer tasks and reminders without opening external task apps. - Categorizing tasks across specific projects or workstreams using assistant instructions to keep work items logically organized. - Modifying task content or deleting obsolete checklist entries via natural language commands during active work sessions. - Marking active tasks as completed to track operational progress and maintain an up-to-date checklist across sessions.

Key facts

• https://github.com/pushyzheng/mcp-todo
• Project & Task Management
• productivity, tasks, todo, tracking

Part of MCP Servers

What is mcp-todo?

mcp-todo is a Model Context Protocol server that manages to-do lists and task tracking through conversational AI interfaces. It exposes tools that allow assistants to create, modify, categorize, and complete tasks locally.

How do I install mcp-todo?

Install project dependencies using rye sync in your local copy of the repository. Then configure your MCP client, such as Claude Desktop, by pointing to the virtual environment Python interpreter and the run.py script while setting the MCP_TODO_CACHE_DIR variable.

What tools and features does mcp-todo provide?

The server provides task addition, task management, and category management. It enables users to record new to-do items, edit contents, mark items as finished, remove tasks, and organize tasks into specific categories.

Which MCP clients work with mcp-todo?

The server works with any client supporting the Model Context Protocol over standard input and output, including Claude Desktop. The project documentation specifically includes configuration instructions for Claude Desktop environments.