Todo MCP Server

@idsulik

Basic information

About Todo MCP Server

The repository todo-mcp-server is a minimal Todo application implemented as an MCP (Model Context Protocol) server. It provides basic functionalities such as listing, viewing, adding, removing, and clearing todo items.

#mcp #mcp-server #modelcontextprotocol

Todo MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "todo-mcp-server-idsulik": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-e",
        "."
      ]
    }
  }
}

Todo MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Todo MCP Server?

A minimal Todo application implemented as an MCP (Model Context Protocol) server. It exposes resources, tools, and prompts to list, view, add, remove, and clear todo items, and to create structured tasks with metadata. The project serves as a test bed for building and interacting with MCP servers.

How to use Todo MCP Server?

Install Python 3.10+ and uv, clone the repository, install dependencies with uv pip install -e ., then register the server with mcp install server.py --name "Todo MCP". Alternatively, use mcp dev server.py to launch with the MCP Inspector, or run via Docker with the configuration shown in the README.

Key features of Todo MCP Server

List all todo items
View a specific todo item by index
Add new todo items
Remove todo items
Clear all todo items
Create structured tasks with priority and due date

Use cases of Todo MCP Server

Testing and demonstrating MCP interactions
Managing a simple todo list through MCP-enabled applications (e.g., Claude Desktop)
Learning how to build and expose functionality via the MCP protocol

Frequently asked questions

What are the prerequisites for running Todo MCP Server?

Python 3.10 or later and the uv Python package installer are required.

How do I install and register the server?

Clone the repository, run `uv pip install -e .` from the project root, then execute `mcp install server.py --name "Todo MCP"` to register it with MCP-enabled apps like Claude Desktop.

How can I run the server using Docker?

Add the provided Docker configuration to your MCP client settings. The image `idsulik/todo-mcp-server` will be pulled automatically if not already present locally.

What tools and resources does Todo MCP Server provide?

Resources: `todo://list` and `todo://view/{item_idx}`. Tools: `add_todo`, `remove_todo`, `clear_todo`. Prompt: `create_task` with parameters for task name, priority, and due date.

Comments

More Productivity MCP servers

docket

Evernow GmbH

Projects, tickets, time and budgets for agencies. Ask about your week, book time, run stopwatches and work on tickets — with exactly the access you have in docket.

JobYap

JobYap aggregates job postings directly from companies' official careers sites and gives every posting a public discussion thread, with salaries, locations and full descriptions.

RADAAR

Official repository bringing RADAAR's social media and content management tools to AI agents like Cursor, VS Code, and ChatGPT. Built on the agent-plugins.org standard, it connects seamlessly to the MCP server. Schedule

LeadSync MCP

lmoulton

LeadSync's MCP server lets Claude, Cursor, OpenAI's Codex and Gemini CLI manage Facebook and Instagram lead ad delivery in a LeadSync account. Connect lead forms to 30+ CRMs, Google Sheets, email and SMS, map fields, add

TripLedger

Pianosa Labs

TripLedger is a personal travel ledger for AI assistants. Connect Claude, ChatGPT, Cursor or any MCP client to log journeys, stays and travel expenses (including from booking emails), then ask for tax-residency day count