MCP Todo.txt Integration

What is MCP Todo.txt Integration?

MCP Todo.txt Integration is a server implementation of the Model Context Protocol (MCP) that enables LLMs to manage tasks in a Todo.txt file programmatically. It integrates with the Todo.txt format and is intended for developers and AI assistants who need structured task management via MCP.

How to use MCP Todo.txt Integration?

Clone the repository, install dependencies with npm install, build with npm run build, then start the server with npm start. The Todo.txt file path can be configured using the TODO_FILE_PATH environment variable; defaults to todo.txt in the project root.

Key features of MCP Todo.txt Integration?

• Expose tasks as a resource with filtering options.
• Add, complete, delete, list, and search tasks.
• Filter and sort tasks by priority, creation, or completion date.
• Add and remove custom metadata from tasks.
• Perform batch updates or deletions.

Use cases of MCP Todo.txt Integration?

• An LLM assistant helps a user manage a daily todo list.
• Batch-process tasks for project management workflows.
• Search and filter tasks by context, project, or priority.
• Programmatically update or remove metadata from tasks.
• Generate task summaries from a Todo.txt file.

FAQ from MCP Todo.txt Integration

What dependencies does it require?

It requires @modelcontextprotocol/sdk, jsTodoTxt, and zod.

How do I configure the Todo.txt file path?

Set the TODO_FILE_PATH environment variable; if not set, the default path is todo.txt in the project root.

What operations can I perform on tasks?

Add, complete, delete, list, search, sort, filter, add/remove metadata, and batch operations.