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

Dadan MCP

Dadan-io

dadan-sdk-integration is an SDK for integrating Dadan features into React applications. It allows you to add video recording and file selection functionality directly into your React components, providing a seamless user

QoreNext Trade Screening MCP

QoreNext

Qorenext Trade screening MCP is a Model Context Protocol server that enables Claude and other AI clients to run sanctions screening and trade-screening due-diligence directly in chat.

Weft

AI PRODUCTS

One board for every AI you use: agents claim tasks and finish with proof you accept or return. Weft is a Scrumban task manager for solo founders and small teams — one board, your sprints, and the AI you already use driv

YouTube Transcript AI

youtube-transcript.ai

Fetch the full transcript of any YouTube video as clean text — no API key, no signup, no quota wall. Pass a YouTube URL (watch, youtu.be, shorts, embed) or a bare video ID and get the transcript back with title and metad

CooperBuild

AdamHicksCooperBuild

AI-native operating system for general contractors: estimates, takeoff, bids, pay apps.

Advertise