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
1. Add Task: Add a new task with optional metadata.
2. Mark Task as Completed: Mark a task as completed.
3. Delete Task: Remove a task.
4. List Tasks: Retrieve all tasks with filtering options.
5. Search Tasks: Search for tasks based on keywords or metadata.
6. Sort Tasks: Sort tasks by priority, creation date, or completion date.
7. Filter Tasks: Filter tasks by specific criteria.
8. Add Metadata: Add custom metadata to tasks.
9. Remove Metadata: Remove specific metadata from tasks.
10. 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

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_PATH environment variable. If not set, the default path is todo.txt in the project root.

Development

To run the project in development mode:
npm run dev
To run tests:
npm test

Dependencies

@modelcontextprotocol/sdk
jsTodoTxt
zod

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.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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

Notion MCP
Badhansen
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
Last updated -
13
Python
MIT License
Todo List MCP Server
RegiByte
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.
Last updated -
10
4
TypeScript
MIT License
Coding Todo Server
dennismartis
-
security
F
license
-
quality
An 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
Python
Todoist MCP
Doist
A
security
A
license
A
quality
An MCP server that enables LLMs to interact with Todoist tasks, projects, and other features through the Todoist API.
Last updated -
36
121
66
TypeScript
MIT License

View all related MCP servers

MCP Todo.txt Integration