todolist-mcp

A basic todolist MCP backed by SQLite

Python MIT
View on GitHub
1 Stars
1 Forks
0 Issues

Languages

Python 92.1% CSS 7.6%

Top Contributors

wdm0006 wdm0006 17

Project Info

Created
May 7, 2025
Last Updated
February 15, 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.