Advertise
MCP.so
Sign In

Todo.txt MCP Server

@danielmeint

Repository

Basic information

Category

Productivity

License

MIT license

Transports

stdio

Author

danielmeint

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

Todo.txt MCP Server config

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

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

Todo.txt MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

Frequently asked questions

1

What are the runtime requirements?

Python 3.10 or later is required.

2

Where does my todo data live?

All processing is local; your todos never leave your device and no network requests are made.

3

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.

4

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.

5

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

My AskAI

My AskAI

Use My AskAI to find product, setup, integration, API, feature, pricing, and troubleshooting information. Search the public knowledge base, read complete documentation and OpenAPI files, and estimate pricing from monthly

AgentGrid.io (by Anima)

Anima

Shared workspace for humans and AI agents by Anima. Create, version, publish, and share live apps, docs, and files from any agent, with per-agent access control. Support all types of agents: Grok Bot, Muse AI, OpenAI Dot

WhatsMCP

whatsmcp

WhatsMCP — WhatsApp for AI agents. Put an AI agent on a real WhatsApp number. Expose regular WhatsApp accounts to your LLM agents over JSON-RPC. A complete Model Context Protocol server that turns phone numbers into addr

EQIQs

EQIQs

EQIQs brings working-style and compatibility insights into Claude. Managers and coaches can take or send a short assessment, compare two people, get a read on a team of up to 12, prepare for meetings with tips that fit t

1

B2B Creators

Social Tree Global

B2B Creators is the LinkedIn content layer for outbound teams. Sales teams run outreach from their team members' personal profiles, but those profiles sit empty. B2B Creators plans, approves and publishes content across

Advertise