1. Conduid
  2. Productivity
  3. Todotxt
MCP server · Productivity

Todotxt

by · github.com/guifelix/mcp-server-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.

Unclaimed last commit a year ago productivity
InstallView source
41Fair

Scored 11 hours ago · breakdown

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.

The repository has 9 stars and 5 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 before depending on it in production.

Install

From source
git clone https://github.com/guifelix/mcp-server-todotxt

This 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

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

Security checks

Static checks derived from the repository yesterday. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • !License declaredNo license file. Legally you have no right to use it in a product.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v1.2.0v1.2.0 · 20 Jul 20251.2.0 (2025-07-20) Features package.json: add bin field for command line interface (a7ece71)
v1.1.2v1.1.2 · 9 Jun 20251.1.2 (2025-06-09) Bug Fixes index.ts: add shebang for Node.js execution (db52f2d)
v1.1.1v1.1.1 · 5 Jun 20251.1.1 (2025-06-05) Bug Fixes .gitignore: comment out package-lock.json to prevent accidental inclusion (213164a)
v1.1.0v1.1.0 · 5 Jun 20251.1.0 (2025-06-05) Features tools: refactor tool registration and enhance task management functions (6d2fdc4) Bug Fixes package: add missing test script to package.json (7af34ad)
v1.0.0v1.0.0 · 5 Jun 20251.0.0 (2025-06-05) Features add vitest config file for test setup (dac009e) add vitest, and ts-node to devDependencies (dac009e) initial project structure with CI, docs, and TypeScript setup (bf627a0)

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.

README fetched from the repository yesterday. The original is authoritative.

Questions

About Todotxt

How do I install Todotxt?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Todotxt safe to use with an AI agent?

Its trust score is 41 out of 100 (fair). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Todotxt still maintained?

The last commit was a year ago and 1 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.