TodoMD

GitHub
Integrates with
TODO.md, CHANGELOG.md

mcp-todo-server

Model Context Protocol (MCP) server for managing TODO.md and CHANGELOG.md files.

Features

  • Precise, line-based editing and reading of file contents.
  • Efficient partial file access using line ranges, for efficient LLM tool usage.
  • Retrieve specific file content by specifying line ranges.
  • Fetch multiple line ranges from multiple files in a single request.
  • Apply line-based patches, correctly adjusting for line number changes.
  • Supports a wide range of character encodings (utf-8, shift_jis, latin1, etc.).
  • Perform atomic operations across multiple files.
  • Robust error handling using custom error types.
  • Adheres to Semantic Versioning and Keep a Changelog conventions.

Requirements

  • Go v1.23+
  • Linux, macOS, or Windows
  • File system permissions for read/write operations

Installation

go install codeberg.org/mutker/mcp-todo-server/cmd/mcp-todo-server@latest

Usage examples:

  • Ask "What are my current tasks for version 0.2.0?"
  • Say "Add a new task to implement OAuth authentication for version 0.2.0"
  • Request "Generate a changelog entry for version 0.1.0 based on completed tasks"
  • Say "Import my existing TODO.md file from /path/to/my/TODO.md"

The server intelligently handles task parsing, version management, and provides rich semantic understanding of tasks and changelog entries.

Available MCP Tools

TODO.md Operations

  • get-todo-tasks - Get all tasks from TODO.md
  • get-todo-tasks-by-version - Get tasks for a specific version
  • add-todo-task - Add a new task for a specific version
  • update-todo-task - Update an existing task
  • add-todo-version - Add a new version section
  • import-todo - Import and format an existing TODO.md

CHANGELOG.md Operations

  • get-changelog - Get all changelog entries
  • get-changelog-by-version - Get changelog entries for a specific version
  • add-changelog-entry - Add a new changelog version entry
  • update-changelog-entry - Update an existing changelog entry
  • import-changelog - Import and format an existing CHANGELOG.md
  • generate-changelog-from-todo - Generate a new CHANGELOG.md entry based on completed tasks in TODO.md

Thanks

License

This project is licensed under the MIT License. See LICENSE for the full license text.