📋

Todotxt

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.

0 installs

9 stars

6 forks

Trust: 41 — Fair

Productivity

Installation

npx mcp-server-todotxt

Ask AI about Todotxt

I know everything about Todotxt. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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

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_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.