What is Mcp Todo Server

mcp-todo-server is a Model Context Protocol (MCP) server designed for managing TODO.md and CHANGELOG.md files, enabling precise editing and retrieval of task and changelog information.

Use cases

Use cases include managing tasks for different software versions, generating changelog entries based on completed tasks, importing existing TODO.md and CHANGELOG.md files, and performing updates or modifications to task lists.

How to use

To use mcp-todo-server, install it via Go with the command ‘go install codeberg.org/mutker/mcp-todo-server/cmd/mcp-todo-server@latest’. You can interact with the server by sending requests to manage tasks and changelog entries, such as adding tasks, retrieving specific entries, or importing existing files.

Key features

Key features include line-based editing and reading, efficient partial file access, support for multiple character encodings, atomic operations across files, and robust error handling. It also adheres to Semantic Versioning and Keep a Changelog conventions.

Where to use

mcp-todo-server can be used in software development environments, project management tools, and any application that requires organized task and changelog management.

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

• tumf/mcp-text-editor for the inspiration.

License

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