Todo List MCP Server

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