MCPgee
MCPgee
MCPgeeMCPgee

Todo.txt

v1.0.0•Knowledge & Memory•stable

MCP Todo.txt Integration is an MCP server for managing Todo.txt tasks. Add, update, filter, and organize tasks programmatically via the MCP protocol. Features include searching, sorting, metadata, batch operations, and dynamic updates.

todotxtmcpai-integration
Share:
9
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Todo.txt?

Todo.txt is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp todo.txt integration is an mcp server for managing todo.txt tasks. add, update, filter, and organize tasks programmatically via the mcp protocol. features include searching, sorting, metadata, bat...

MCP Todo.txt Integration is an MCP server for managing Todo.txt tasks. Add, update, filter, and organize tasks programmatically via the MCP protocol. Features include searching, sorting, metadata, batch operations, and dynamic updates.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP Todo.txt Integration is an MCP server for managing Todo.

Use Cases

Manage Todo.txt tasks through Claude with search and filtering.
Automate task organization and metadata updates.
guifelix

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedFeb 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx todotxt

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Todo.txt

The Todo.txt MCP server brings the simplicity of the plain-text Todo.txt format directly into Claude. You can add, complete, delete, search, filter, sort, and batch-update tasks programmatically through the MCP protocol, with all changes persisted to a local todo.txt file. It also exposes prompt helpers for summarizing your task list and generating new task descriptions.

Prerequisites

  • Node.js 18 or later installed
  • npm or npx available on your PATH
  • A Claude desktop client that supports MCP (Claude Desktop or compatible)
  • An existing or new todo.txt file at a known path on disk
1

Clone the repository

Clone the mcp-server-todotxt repository from GitHub and enter the project directory.

git clone https://github.com/guifelix/mcp-server-todotxt.git
cd mcp-server-todotxt
2

Install dependencies and build

Install npm dependencies and compile the TypeScript source to JavaScript.

npm install
npm run build
3

Set the Todo.txt file path

The server reads the TODO_FILE_PATH environment variable to locate your task file. If unset it defaults to todo.txt in the project root. Point it at your actual file.

export TODO_FILE_PATH="/Users/you/Documents/todo.txt"
4

Start the MCP server

Run the compiled server. Keep this process running while Claude Desktop is open.

npm start
5

Add the server to Claude Desktop config

Edit your Claude Desktop configuration file to register the Todo.txt MCP server using the absolute path to the built entry point.

{
  "mcpServers": {
    "todotxt": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-todotxt/dist/index.js"],
      "env": {
        "TODO_FILE_PATH": "/Users/you/Documents/todo.txt"
      }
    }
  }
}
6

Restart Claude Desktop and verify

Restart Claude Desktop so it picks up the new server entry. Open a new conversation and ask Claude to list your tasks to confirm the connection is working.

Todo.txt Examples

Client configuration

Complete claude_desktop_config.json snippet for the Todo.txt MCP server with a custom task file location.

{
  "mcpServers": {
    "todotxt": {
      "command": "node",
      "args": ["/Users/you/mcp-server-todotxt/dist/index.js"],
      "env": {
        "TODO_FILE_PATH": "/Users/you/Documents/todo.txt"
      }
    }
  }
}

Prompts to try

Example natural-language requests you can send to Claude once the server is connected.

- "List all my open tasks"
- "Add a new task: Buy groceries +shopping @errands due:2026-06-20"
- "Mark task 3 as completed"
- "Search my tasks for anything tagged @work"
- "Sort my task list by priority"
- "Summarize my current task list"

Troubleshooting Todo.txt

Claude reports it cannot find the todo.txt file

Ensure TODO_FILE_PATH in the env block of claude_desktop_config.json is an absolute path and that the file exists. Relative paths are resolved from the server process working directory, which may differ from what you expect.

The server starts but Claude shows no todotxt tools

Check that the args path points to the compiled dist/index.js file (not the TypeScript source). Run npm run build again and confirm the dist/ directory was created.

Batch operations partially fail

Verify each task ID referenced in a batch operation exists in your todo.txt. The server uses 1-based line numbers; any mismatch will cause individual items in the batch to fail silently.

Frequently Asked Questions about Todo.txt

What is Todo.txt?

Todo.txt is a Model Context Protocol (MCP) server that mcp todo.txt integration is an mcp server for managing todo.txt tasks. add, update, filter, and organize tasks programmatically via the mcp protocol. features include searching, sorting, metadata, batch operations, and dynamic updates. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Todo.txt?

Follow the installation instructions on the Todo.txt GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Todo.txt?

Todo.txt works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Todo.txt free to use?

Yes, Todo.txt is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Todo.txt Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Todo.txt? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "todotxt": { "command": "npx", "args": ["-y", "todotxt"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Todo.txt?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides