Todo.txt MCP Server

by danielmeint

421 downloads
Not rated
GitHub

About

πŸ”— Model Context Protocol server for todo.txt files - Connect your todo.txt to AI assistants like Claude Desktop

Details

Author
danielmeint
Downloads
421
Categories
Productivity, AI, Project Management

- 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

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Todo.txt MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

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"
        ]
    }
}

Todo.txt MCP Server

PyPI version
Python 3.10+
License: MIT

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

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.