To Do List MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@To Do List MCP add buy groceries and call mom to my to-do list"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
To Do List MCP
A minimal Model Context Protocol server that exposes a
personal to-do list backed by SQLite. Built with the official Python
mcp SDK.
Tools
Tool | Description | Arguments |
| Add a task, or a list of tasks in one call |
|
| List all incomplete tasks | — |
| Rename a task and/or set its status |
|
| Mark a task complete |
|
Tasks are stored in todolist.db (SQLite), created automatically on first run in the
server's working directory.
Related MCP server: TodoSQLite MCP Server
Requirements
Python >= 3.13
Installation
Clone the repo and install dependencies with uv:
uv syncUsage
Claude Desktop
Add the server to your claude_desktop_config.json (Claude menu → Settings →
Developer → Edit Config), or install it automatically with the MCP CLI:
uv run mcp install src/to_do_list_mcp/server.py --name "To Do List"This adds an entry like the following:
{
"mcpServers": {
"To Do List": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"/absolute/path/to/to_do_list_mcp/src/to_do_list_mcp/server.py"
]
}
}
}Restart Claude Desktop afterwards for the server to be picked up.
Development
Run the server directly with the MCP Inspector for interactive testing:
uv run mcp dev src/to_do_list_mcp/server.pyLicense
No license specified.
Available Tools
4 toolstask_addD
Inputs: task_name (required).
task_completeD
Inputs: task_id (required). Returns: result
task_getD
Inputs: no named parameters.
task_updateD
Inputs: task_id (required), task_name (required), task_status. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
task_add, task_update, task_complete, and task_get target reasonably distinct actions on a task. However, task_complete overlaps with task_update (completing is a specialized update), and the absence of descriptions leaves boundaries somewhat implicit.
All four tools follow a strict task_<verb> snake_case pattern with no deviations. The convention is predictable and immediately readable.
Four tools is a sensible, well-scoped surface for a simple to-do list server. It is on the lean side but each tool maps to a clear operation.
The set covers create, read, update, and complete, but lacks a list/query-all operation and a delete/remove operation. These are notable gaps for a to-do domain that will force agents to work around missing lifecycle steps.
Related MCP Connectors
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Simple, fast todo app: manage tasks, projects and tags from Claude and other MCP clients.
Add items to your tidee workspace from ordinary language, read what is there, and mark things done.
Create, list, and complete todo items through MCP.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables task management through natural language commands in English or Spanish. Supports creating, listing, updating, completing, and deleting tasks with local SQLite storage.7-
- AlicenseNot gradedqualityDmaintenanceEnables users to manage a personal todo list with CRUD operations, keyword search, and local SQLite storage. Designed for AI agent productivity tools.MIT
- FlicenseNot gradedqualityDmaintenanceEnables CRUD operations on a SQLite task database with filtering by status and priority.-
- FlicenseNot gradedqualityDmaintenanceEnables managing daily work logs with tools for adding, listing, updating status, deleting, and summarizing tasks, using SQLite for persistent storage.-