Todo.txt MCP Server

What is Todo.txt MCP Server?

Todo.txt MCP Server is a Model Context Protocol server that connects your todo.txt files to AI assistants like Claude Desktop. It manages your todo list through natural language while maintaining the simplicity and portability of the todo.txt format.

How to use Todo.txt MCP Server?

Install via uvx todo-txt-mcp or uv tool install todo-txt-mcp. Then add it to your Claude Desktop configuration (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json) using the JSON snippet provided, and restart Claude Desktop. Optionally pass a custom todo.txt file path as an argument.

Key features of Todo.txt MCP Server

• Natural language interface for todo management
• Full CRUD operations (create, read, update, delete)
• Smart filtering by text, priority, projects, and contexts
• Statistics and insights on your productivity
• Automatic detection of existing todo.sh configurations
• Automatic backups and configurable file size limits

Use cases of Todo.txt MCP Server

• Add a high-priority task to your todo list via natural language
• Search for all work-related items using project or context tags
• Mark multiple todos as completed in one conversation
• Get a productivity summary with counts per priority or context
• Modify or delete existing todos without opening the file manually

FAQ from Todo.txt MCP Server

What are the runtime requirements?

Python 3.10 or later is required.

Where does my todo data live?

All processing is local; your todos never leave your device and no network requests are made.

Does Todo.txt MCP Server work with my existing todo.sh setup?

Yes, it automatically detects your todo.sh configuration file (~/.todo/config, ~/.todo.cfg, etc.) and works with the same todo.txt file.

How can I use a custom todo.txt file?

Pass the file path as a command argument when configuring the server in Claude Desktop, or set the TODO_MCP_TODO_FILE_PATH environment variable.

What file safety measures are included?

Automatic backups are enabled by default, and you can configure a maximum file size limit with the TODO_MCP_MAX_FILE_SIZE environment variable.