About Todo Txt MCP
Todo Txt MCP is an MCP server published by danielmeint in the Developer Tools category: 🔗 Model Context Protocol server for todo.txt files - Connect your todo.txt to AI assistants like Claude Desktop.
The repository has 8 stars and 1 forks, with the last commit 9 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/danielmeint/todo-txt-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (10)
add_todoCreate new todos
Parameters not published.
complete_todoMark todos as completed
Parameters not published.
delete_todoRemove todos
Parameters not published.
filter_by_contextFilter by context (@tag)
Parameters not published.
filter_by_priorityFilter by priority (A-Z)
Parameters not published.
filter_by_projectFilter by project (+tag)
Parameters not published.
get_statisticsGet todo statistics
Parameters not published.
list_todosList todos with optional filters
Parameters not published.
search_todosFind todos by text
Parameters not published.
update_todoModify existing todos
Parameters not published.
Ask AI
Ask AI about Todo Txt MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
3 checks have not been run yet.
Releases
README
Todo.txt MCP Server
A Model Context Protocol server that connects todo.txt files to AI assistants like Claude. Manage your tasks through natural language while keeping the simplicity and portability of plain text.
Installation
# Recommended
uv tool install todo-txt-mcp
# Or run directly without installing
uvx todo-txt-mcp
# Alternatives
pipx install todo-txt-mcp
pip install todo-txt-mcp
Configuration
Add to your Claude Desktop config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"todo-txt": {
"command": "uvx",
"args": [
"todo-txt-mcp"
]
}
}
}
Restart Claude Desktop. The tools icon confirms the server is connected.
Custom todo.txt location
{
"mcpServers": {
"todo-txt": {
"command": "uvx",
"args": [
"todo-txt-mcp",
"/path/to/your/todo.txt"
]
}
}
}
todo.sh integration
If you use todo.sh, the server automatically detects your config from
~/.todo/config, ~/.todo.cfg, or standard system locations.
Environment variables
TODO_MCP_TODO_FILE_PATH=/path/to/todo.txt
TODO_MCP_BACKUP_ENABLED=true
TODO_MCP_MAX_FILE_SIZE=10000000
Available Tools
| Tool | Description |
|---|---|
list_todos |
List todos with optional filters |
add_todo |
Create new todos |
complete_todo |
Mark todos as completed |
update_todo |
Modify existing todos |
delete_todo |
Remove todos |
search_todos |
Find todos by text |
filter_by_priority |
Filter by priority (A-Z) |
filter_by_project |
Filter by project (+tag) |
filter_by_context |
Filter by context (@tag) |
get_statistics |
Get todo statistics |
Todo.txt Format
Fully compatible with the todo.txt specification:
(A) Call Mom +family @phone
x 2025-05-31 2025-05-30 (B) Buy groceries +shopping @errands
Write project proposal +work @computer
Contributing
See CONTRIBUTING.md for guidelines. Bug reports and feature requests welcome via GitHub Issues.
License
MIT - see LICENSE.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.