A
securityA
licenseA
qualityA Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.
Last updated -
30
MIT License
Used for schema validation in the MCP server implementation, helping to validate and type-check data structures.
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.
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.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A server implementation that enables LLMs to programmatically manage tasks in Todo.txt files using the Model Context Protocol (MCP), supporting operations like adding, completing, deleting, listing, searching, and filtering tasks.
Related MCP Servers
- -securityFlicense-qualityAn MCP server that provides tools and resources for managing a coding project's todo list, allowing users to view, add, update, and delete todo items with details like priority, status, and tags.Last updated -1
- AsecurityAlicenseAqualityAn MCP server that enables LLMs to interact with Todoist tasks, projects, and other features through the Todoist API.Last updated -99181MIT License
- -securityFlicense-qualityA minimal Model Context Protocol server implementation that provides tools for managing a to-do list, allowing users to create tasks, list them, and mark them as completed via JSON-RPC calls.Last updated -