Task / To-Do Manager — MCP Server

A small MCP server that lets an AI assistant manage a simple to-do list. Tasks are stored in tasks.json in this folder — no database required.

Setup

python -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate
pip install -r requirements.txt

Related MCP server: Todo MCP Server

Running the server

python server.py

The server talks over stdio (standard input/output), so it's meant to be launched by an MCP client (like MCP Inspector, or an AI assistant configured to use it) — not run and watched directly in a plain terminal.

To test it by hand, run:

mcp dev server.py

and open the URL Inspector prints. From there you can click each tool below and try it yourself.

Tools

Bonus resource

tasks://pending — a read-only JSON list of every task that isn't done yet. Unlike a tool, it never changes any data; it only displays it.

Error handling

Every tool checks its input first. Missing or invalid data (an empty title, or an id that doesn't exist) returns a clear {"error": "..."} message instead of crashing the server.