About Todotxt
Todotxt is an MCP server published by guifelix in the Productivity category: 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 has been installed 0 times through Conduid.
The repository has 9 stars and 6 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.
Install
npx mcp-server-todotxtThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Todotxt
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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 todomcp -
Install dependencies:
npm install -
Build the project:
npm run build
Usage
-
Start the MCP server:
npm start -
Interact 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 dev -
To 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.
README mirrored from the source repository 3 months ago. The original is authoritative.