MCP.so
Sign In

Todo.txt MCP Server

@danielmeint

Repository

About Todo.txt MCP Server

🔗 Model Context Protocol server for todo.txt files - Connect your todo.txt to AI assistants like Claude Desktop

#python#productivity#todo#ai#mcp#natural-language#artificial-intelligence#todo-txt#task-management#claude#todo-management#ai-assistant#claude-desktop#model-context-protocol#mcp-server

Basic information

Category

Productivity

License

MIT license

Runtime

python

Transports

stdio

Publisher

danielmeint

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "todo-txt-mcp": {
      "command": "uvx",
      "args": [
        "todo-txt-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Comments

More Productivity MCP servers

MCP SAP GUI Server

mario-andreschak

MCP server that allows simple SAP GUI interaction for LLM models using simulated mouse clicks and keyboard input.

120

Computer Control MCP

AB498

MCP server that provides computer control capabilities, like mouse, keyboard, OCR, etc. using PyAutoGUI, RapidOCR, ONNXRuntime. Similar to 'computer-use' by Anthropic. With Zero External Dependencies.

150

ATLAS: Task Management System

cyanheads

A Model Context Protocol (MCP) server for ATLAS, a Neo4j-powered task management system for LLM Agents - implementing a three-tier architecture (Projects, Tasks, Knowledge) to manage complex workflows. Now with Deep Research.

475

Openfate Bazi Mcp

openfate-ai

OpenFate Bazi MCP server with deterministic Four Pillars calculation, True Solar Time, branch interactions, and reverse Bazi lookup.

76

Time

modelcontextprotocol

Model Context Protocol Servers

88.2K