MCP Todo.txt Integration
Used for schema validation in the MCP server implementation, helping to validate and type-check data structures.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Todo.txt Integration add a task to buy groceries with priority A and project home"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Todo.txt Integration
Overview
The MCP Todo.txt Integration is a server implementation of the Model Context Protocol (MCP) that enables interaction with Todo.txt files. This project allows LLMs to manage tasks in a Todo.txt file programmatically using the MCP protocol.
Related MCP server: Todoist MCP Server
Features
Core Features
Resources
Expose the list of tasks as a resource.
Filter tasks by context, project, or priority.
Tools
Add Task: Add a new task with optional metadata.
Mark Task as Completed: Mark a task as completed.
Delete Task: Remove a task.
List Tasks: Retrieve all tasks with filtering options.
Search Tasks: Search for tasks based on keywords or metadata.
Sort Tasks: Sort tasks by priority, creation date, or completion date.
Filter Tasks: Filter tasks by specific criteria.
Add Metadata: Add custom metadata to tasks.
Remove Metadata: Remove specific metadata from tasks.
Batch Operations: Perform batch updates or deletions.
Prompts
Summarize tasks.
Generate a new task description.
Advanced Features
Dynamic Task Management: Update tasks dynamically based on input or triggers.
Session Management: Manage tasks across multiple requests.
Installation
For quick installation, use the one-click installation button below
Clone the repository:
git clone <repository-url> cd todomcpInstall dependencies:
npm installBuild the project:
npm run build
Usage
Start the MCP server:
npm startInteract with the server using MCP-compliant clients or tools.
Configuration
The path to the Todo.txt file can be configured using the
TODO_FILE_PATHenvironment variable. If not set, the default path istodo.txtin the project root.
Development
To run the project in development mode:
npm run devTo run tests:
npm test
Dependencies
@modelcontextprotocol/sdkjsTodoTxtzod
Documentation
Contributing
Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.
License
This project is licensed under the MIT License.
Available Tools
11 toolsadd-metadataB
Add custom metadata (key-value pairs) to a task by ID.
Inputs: taskId (required), metadata (required).
add-taskB
Add a new task to the todo list. Description must be plain text. Priority must be a single uppercase letter (A-Z). Contexts must start with @, projects with +.
Inputs: description (required), priority, contexts, projects, +1 more.
batch-operationsB
Perform batch operations (update, delete, mark-complete) on tasks matching criteria.
Inputs: operations (required).
complete-taskB
Mark a task as completed by its 1-based ID.
Inputs: taskId (required).
delete-taskB
Delete a task by its 1-based ID.
Inputs: taskId (required).
filter-tasksC
Filter tasks by specific criteria (priority, context, project).
Inputs: criteria (required).
list-tasksC
List all tasks, optionally filtered by priority, context, project, or metadata.
Inputs: filter.
remove-metadataC
Remove specific metadata keys from a task by ID.
Inputs: taskId (required), keys (required).
search-tasksB
Search for tasks containing a query string.
Inputs: query (required).
sort-tasksC
Sort tasks by priority, creation date, or completion date.
Inputs: by (required).
update-taskC
Update a task's fields (description, priority, contexts, projects, metadata) by ID.
Inputs: taskId (required), updates (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools have clear, distinct purposes (add, update, delete, complete, list, search, sort, filter, metadata operations). However, filter-tasks and list-tasks overlap somewhat since list-tasks already supports filtering by priority, context, project, or metadata, which could cause an agent to pick the wrong one.
Tool names consistently use a verb-noun pattern (add-task, update-task, delete-task, list-tasks, search-tasks, sort-tasks, complete-task). Minor deviations: batch-operations is a noun phrase rather than verb-noun, and filter-tasks overlaps with list-tasks' filtering capability.
11 tools is a reasonable count for a todo.txt server covering task CRUD, metadata, search, sorting, filtering, and batch operations. It is slightly on the higher side but each tool addresses a distinct operation, so the count feels appropriate.
The tool set covers the core todo.txt lifecycle well: add, list, update, complete, delete, search, sort, filter, and metadata management. Minor gaps include no explicit undo/reopen-completed-task operation and no way to move tasks between lists, but these are not critical for a todo.txt integration.
Maintenance
Related MCP Connectors
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.10 npm46MIT
- AlicenseNot gradedqualityCmaintenanceA Model Context Protocol server that enables advanced task and project management in Todoist via Claude Desktop and other MCP-compatible clients.99 npm2MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server implementation compatible with Todoist API, allowing AI agents to interact with task management functionality through standardized MCP tools.518 npm1MIT
- AlicenseAqualityDmaintenanceA Python MCP server that enables AI assistants to manage Todoist tasks and projects through the Model Context Protocol. It supports full CRUD operations for tasks and projects, including support for nested projects and Todoist's advanced filter syntax.11MIT