todo-txt

This MCP server exposes a Todo.txt-powered task manager via the Model Context Protocol. It connects to your todo.txt file and presents natural-language capable tools to list, add, update, search, filter, and report on your tasks. The server supports common Todo.txt operations through a set of dedicated tools such as list_todos, add_todo, complete_todo, update_todo, delete_todo, search_todos, and various filters (filter_by_priority, filter_by_project, filter_by_context) plus get_statistics for quick insights.

To use it, ensure the Todo.txt MCP is running with the appropriate configuration (via uvx todo-txt-mcp). Once connected, you can interact with the tools through your AI assistant or client that supports MCP, issuing commands like asking to list open tasks, add a new task with a specific priority, or filter tasks by a project tag. The server preserves compatibility with the standard todo.txt format, so your existing notes remain portable while enabling AI-assisted task management.

Prerequisites:

• Python 3.10+ installed on your system
• uv (universal viewer) or uvx tool installed to run MCP servers (as described below)

Installation options:

1. Recommended (uv):

   • Install the MCP via the uv tool: uv tool install todo-txt-mcp
   • Run directly without installation: uvx todo-txt-mcp

2. Alternatives (pipx/pip):

   • pipx installation: pipx install todo-txt-mcp
   • Or plain pip installation (if available in your environment): pip install todo-txt-mcp

Notes:

• The recommended approach is to use uv/uvx for quick starts, but pipx/pip can be used if you prefer traditional Python package management.
• Ensure your environment variables (if used) are configured as described in the docs to point to your todo.txt file and options.

Environment variables you may configure:

• TODO_MCP_TODO_FILE_PATH: Path to your todo.txt file
• TODO_MCP_BACKUP_ENABLED: Enable/disable automatic backups (true/false)
• TODO_MCP_MAX_FILE_SIZE: Maximum allowed file size in bytes before warnings or limits apply

Tips:

• If you use todo.sh, the server can detect configuration from common locations like ~/.todo/config or ~/.todo.cfg automatically.
• For custom locations, adjust the input tuple in the MCP config to pass the path to your todo.txt file as an argument.
• Restart the Claude Desktop (or your client) after updating the MCP configuration so the connection is re-established.