todo-mcp-server

# 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 ```bash pip install . ``` ## Usage ```bash todo-mcp-server ``` ## Development ```bash # Activate virtual environment source .venv/bin/activate # Run tests pytest # Format code ruff check . ``` ## License Public Domain (Unlicense)