Todo.txt MCP Server
About
🔗 Model Context Protocol server for todo.txt files - Connect your todo.txt to AI assistants like Claude Desktop
Details
- License
- MIT license
Explore
- 🔍 Natural Language Interface: Ask AI to find, create, and manage your todos
- 📝 Full CRUD Operations: Create, read, update, and delete todos with AI assistance
- 🎯 Smart Filtering: Search by text, priority, projects (+project), or contexts (@context)
- 📊 Statistics & Insights: Get comprehensive stats about your productivity
- 🔄 todo.sh Integration: Automatically works with existing todo.sh setups
- 💾 File Safety: Automatic backups and configurable safety limits
- ⚡ Modern Installation: Install with uvx, uv, pipx, or pip
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Todo.txt MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
uvx todo-txt-mcp
uv tool install todo-txt-mcp
<details>
<summary>More installation options</summary>
pipx install todo-txt-mcp
Add to your Claude Desktop configuration:
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"]
}
}
}
If you're already using todo.sh, the server automatically detects your configuration:
- ~/.todo/config
- ~/.todo.cfg
- /etc/todo/config
- /usr/local/etc/todo/config
Specify a custom todo.txt file:
{
"mcpServers": {
"todo-txt": {
"command": "uvx",
"args": ["todo-txt-mcp", "/path/to/your/todo.txt"]
}
}
}
Configure via environment variables:
TODO_MCP_TODO_FILE_PATH=/path/to/todo.txt
TODO_MCP_BACKUP_ENABLED=true
TODO_MCP_MAX_FILE_SIZE=10000000
```
list_todos
List all todos (with optional filters)
add_todo
Create new todo items
complete_todo
Mark todos as completed
update_todo
Modify existing todos
delete_todo
Remove todos
search_todos
Find todos by text content
filter_by_priority
Filter by priority level (A-Z)
filter_by_project
Filter by project tags (+project)
filter_by_context
Filter by context tags (@context)
get_statistics
Get comprehensive todo statistics
The server provides these MCP tools for AI interaction:
| Tool | Description |
|------|-------------|
| list_todos | List all todos (with optional filters) |
| add_todo | Create new todo items |
| complete_todo | Mark todos as completed |
| update_todo | Modify existing todos |
| delete_todo | Remove todos |
| search_todos | Find todos by text content |
| filter_by_priority | Filter by priority level (A-Z) |
| filter_by_project | Filter by project tags (+project) |
| filter_by_context | Filter by context tags (@context) |
| get_statistics | Get comprehensive todo statistics |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"todo.txt mcp server": {
"todo-txt-mcp": {
"command": "uvx",
"args": [
"todo-txt-mcp"
]
}
}
}
}McpServers
{
"todo-txt-mcp": {
"command": "uvx",
"args": [
"todo-txt-mcp"
]
}
}
A powerful Model Context Protocol (MCP) server that connects your todo.txt files to AI assistants like Claude Desktop. Manage your todo list through natural language while maintaining the simplicity and portability of the todo.txt format.
✨ Features
- 🔍 Natural Language Interface: Ask AI to find, create, and manage your todos
- 📝 Full CRUD Operations: Create, read, update, and delete todos with AI assistance
- 🎯 Smart Filtering: Search by text, priority, projects (+project), or contexts (@context)
- 📊 Statistics & Insights: Get comprehensive stats about your productivity
- 🔄 todo.sh Integration: Automatically works with existing todo.sh setups
- 💾 File Safety: Automatic backups and configurable safety limits
- ⚡ Modern Installation: Install with uvx, uv, pipx, or pip
🚀 Quick Start
1. Install
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
