todolist-mcp

Languages

Python 94.5% CSS 5.2%

Top Contributors

Project Info

Created

May 7, 2025

Last Updated

September 8, 2026

License

MIT

Default Branch

main

About This Project

TodoList MCP is an MCP server that gives AI assistants a proper todo list backed by SQLite. It also ships with a FastAPI/HTMX kanban board so humans can see and manage the same tasks visually. Both interfaces share the same database.

Features

• Six MCP Tools: Add items (with priority, due dates, tags), list with filters/sorting, update fields, mark completion, delete, and access a workflow guide
• Dual Interface: MCP server for AI assistants plus a kanban web board for humans
• Shared SQLite Database: Both interfaces read and write to the same DB
• Drag-and-Drop Kanban: Visual task management with color-coded priorities and tags
• No Build Process: The web UI uses HTMX, no JavaScript build step required

Installation

# Run directly
uvx --from git+https://github.com/wdm0006/todolist-mcp todolist-mcp

# Or add to your MCP client config
{
  "mcpServers": {
    "todolist": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/wdm0006/todolist-mcp", "todolist-mcp"]
    }
  }
}

Usage

The MCP server exposes tools for adding, listing, updating, completing, and deleting tasks. The kanban board runs on a local web server for visual management alongside your AI workflow.