mcpField
M
MCP Todo.txt Integration

MCP Todo.txt Integration

Local
github.com/guifelixProductivity9Updated 66w ago
Repository

About MCP Todo.txt Integration

MCP Todo.txt Integration is a server that lets LLMs manage tasks in Todo.txt files through MCP. It includes task filtering, sorting, search, metadata management, and batch operations.

Key features

  1. 01Add, complete, and delete tasks
  2. 02Filter and sort tasks
  3. 03Search by keyword or metadata
  4. 04Manage custom metadata
  5. 05Batch update or delete tasks

Use cases

  1. 01Maintain Todo.txt through an MCP client
  2. 02Organize tasks by project or priority
  3. 03Batch-update tasks and manage metadata

MCP support

The server exposes task resources, task-management tools, and prompts for summarizing tasks or generating task descriptions to MCP clients.

#mcp-server#todo-txt#task-management

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

GitHub Actions Workflow Status NPM Downloads GitHub Downloads (all assets, all releases) NPM Version License Types Last Commit GitHub issues GitHub starts Verified on MseeP

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

Install with NPX in VS Code

  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

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.