<div align="center">

Todo List MCP Server

</div>

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"
    ]
}

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