Skip to main content
Glama

todo-list-mcp

Todo List MCP Server

License: MIT Python Ruff uv

A Model Context Protocol (MCP) server that provides:

  • Todo List Management: Persistent todo list with SQLite database storage

  • Reminder Service: Desktop notifications with optional sound alerts

  • Cross-platform Sound System: Sound playback on Windows, macOS, and Linux

Quick Start

Prerequisites

  • UV installed

  • Python 3.11 or higher

Configuration

The application stores data in ~/.todo-list-mcp/ directory:

  • todo_list.db - SQLite database for tasks

  • reminder_daemon/ - Reminder daemon data

No additional configuration is required unless you want to customize the database location. You can optionally create a .env file in ~/.todo-list-mcp/ with:

TODO_LIST_MCP__DATABASE_URL=sqlite:///path/to/custom/location.db

VSCode IDE Setup

Enter the following details in your mcp.json configuration file:

"todo-list-mcp": {
    "type": "stdio",
    "command": "uvx",
    "args": [
        "todo-list-mcp@latest"
    ]
}

Related MCP server: Tasks MCP Server

Features

Todo List Management (MCP)

  • SQLite Storage: Store tasks in a local SQLite database for fast, reliable access

  • Flexible Attributes: Track title, description, status, priority, urgency, time estimates, due dates, tags, and assignees

  • Smart Filtering: Query tasks by status, priority, tags, assignee, or due date

  • Lifecycle Management: Create, read, update, and archive tasks directly via MCP tools

  • Archiving: Archive completed tasks while preserving all data for future reference

Reminder System

  • Cross-Platform: Native visual dialogs for Windows, macOS, and Linux

  • Background Service: Reliable daemon process ensures timely notifications

  • Persistence: Local JSON storage in ~/.todo-list-mcp/reminder_daemon/ keeps reminders safe

Sound System

  • Universal Playback: Audio alerts on all supported operating systems

  • Built-in Assets: Includes a chime sound out of the box

  • Advanced Audio: Support for custom WAV files and loop playback with configurable intervals

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables users to manage a persistent todo list through natural language, supporting adding, listing, toggling completion status, and removing todos. Features both stdio and HTTP transports with optional authentication and JSON file storage.
      4
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      A simple, powerful Todo list manager for Claude Desktop and other MCP-compatible AI assistants. Organize your tasks across different projects with priorities and never lose track of what needs to be done!
      9 npm
      2
      MIT