todo-mcp-server

A simple to-do list MCP (Model Context Protocol) server for AI agents.

Overview

This project provides an MCP server that enables AI agents to manage to-do lists through a standardized protocol interface.

Features

• Create, read, update, and delete to-do items
• List scoping: individual agents or entire projects, enabling multiple subagents to collaborate on complex tasks
• MCP protocol integration for seamless AI agent interaction
• Built with Python and MCP SDK

Available tools

• todo_lists_get_all: Return the keys (IDs) of all existing to-do lists.
• todo_list_create: Create a new list or get an existing one by key.
• todo_list_get: Get all items in a list by key.
• todo_item_add: Add a new item to a list.
• todo_item_update: Update an existing item in a list.
• todo_item_remove: Remove an item from a list.
• todo_list_clear: Remove all items from a list (and delete the list).

Installation

pip install .

Usage

todo-mcp-server

Development

# Activate virtual environment
source .venv/bin/activate

# Run tests
pytest

# Format code
ruff check .

License

Public Domain (Unlicense)