dotnet-todo-mcp

A FastMCP server that exposes the dotnet-todo CLI (a Todo.txt port) as MCP tools, making your todo list accessible to AI assistants via the Model Context Protocol.

Prerequisites

Install the todo CLI (.NET global tool):

dotnet tool install -g dotnet-todo

Running the Server

Via uvx (from PyPI):

uvx dotnet-todo-mcp

Local development (from the project directory):

uv sync
uv run python server.py

Tools

Todo item format: 02 (D) 2023-07-30 Task description @context +project

MCP Client Configuration

Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "todo": {
      "command": "uvx",
      "args": [
        "--from",
        "dotnet-todo-mcp",
        "todo-mcp"
      ]
    }
  }
}

Local development — point at your local clone:

{
  "mcpServers": {
    "todo": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/dotnet-todo-mcp", "todo-mcp"]
    }
  }
}

This requires that you run uv sync first.