todolist-mcp

MCP server for managing todo lists.

Install

Install and configure the MCP from https://mcginniscommawill.com/oss/todolist-mcp/ now. Follow the documentation's installation instructions, ask me for anything you can't complete yourself, and verify its tools load.

View documentation

README

Languages

Python 94.6% CSS 5.1%

Top Contributors

Project Info

Created

May 7, 2025

Last Updated

October 3, 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.