What is Mcp Server Todotxt

mcp-server-todotxt is an MCP server designed for managing Todo.txt tasks programmatically. It allows users to add, update, filter, and organize tasks using the MCP protocol.

Use cases

Use cases include automating task management for teams, integrating with other applications to manage tasks, and using it in personal productivity tools.

How to use

To use mcp-server-todotxt, clone the repository, install the dependencies, and interact with the server to manage your Todo.txt tasks through various commands such as adding, completing, or deleting tasks.

Key features

Key features include dynamic task management, batch operations, task filtering by context or priority, and the ability to add or remove metadata from tasks.

Where to use

mcp-server-todotxt can be used in project management, personal task management, and any scenario where Todo.txt files are utilized for organizing tasks.

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

1. Clone the repository:

   git clone <repository-url>
   cd todomcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Usage

1. Start the MCP server:

   npm start
   

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

• Todo.txt Format
• jsTodoTxt 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.