Skip to main content
Glama
l0kifs

todo-list-mcp

by l0kifs
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Todo

    CalamityAdam
    F
    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
    -

  • todo-mcp

    floriscornel
    A
    license
    Not graded
    quality
    C
    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!
    4 npm
    2
    MIT