Todo Manager MCP server

This MCP server provides an efficient way to manage TODO.md and CHANGELOG.md files, offering precise, line-based editing and reading capabilities that follow Semantic Versioning and Keep a Changelog conventions. The server enables structured task and changelog management through a semantic understanding of file contents.

Requirements

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

Installation

Installing the MCP Todo Server is straightforward using Go's package manager:

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

Usage Examples

The MCP Todo Server can be used with natural language requests such as:

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

The server processes these requests by intelligently parsing tasks, managing versions, and providing rich semantic understanding of tasks and changelog entries.

Available MCP Tools

TODO.md Operations

The server provides several tools for managing your TODO.md file:

• get-todo-tasks - Retrieve all tasks from TODO.md
• get-todo-tasks-by-version - Retrieve 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

For CHANGELOG.md management, the following tools are available:

• get-changelog - Retrieve all changelog entries
• get-changelog-by-version - Retrieve 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

Features

The MCP Todo Server includes the following key capabilities:

• Precise, line-based editing and reading of file contents
• Efficient partial file access using line ranges
• Multi-file operations in a single request
• Line-based patching with automatic line number adjustment
• Support for various character encodings (utf-8, shift_jis, latin1, etc.)
• Atomic operations across multiple files
• Robust error handling

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.