1. Conduid
  2. Productivity
  3. Todo List MCP
MCP server · Productivity

Todo List MCP

by · github.com/l0kifs/todo-list-mcp

An MCP server for managing todos within LLMs, created for educational purposes

Unclaimed MIT last commit 8 months ago productivity
InstallView source
54Fair

Scored 7 days ago · breakdown

About Todo List MCP

Todo List MCP is an MCP server published by l0kifs in the Productivity category: an MCP server for managing todos within LLMs, created for educational purposes.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/l0kifs/todo-list-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Todo List MCP

Powered by Claude · Grounded in docs

I know everything about Todo List MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

3 checks have not been run yet.

Releases

v0.3.1v0.3.1 - Task Deletion Support · 22 Jan 2026What's New Added delete_tasks MCP tool for permanently removing tasks by ID Support for batch deletion with multiple task IDs Comprehensive e2e test coverage for delete functionality Details This release adds the ability to delete tasks…
v0.3.0v0.3.0 - wxPython Reminder Client · 22 Jan 2026What's Changed Added wxPython-based reminder client for improved cross-platform desktop notifications macOS-specific improvements: Added threading and UI handling optimizations for wxPython on macOS Replaced Tkinter with wxPython in…
v0.2.0v0.2.0 - SQLite Storage Migration · 13 Jan 2026Major Changes BREAKING CHANGE: This release migrates from GitHub-based task storage to local SQLite database. What's Changed Storage Architecture Replaced GitHub storage with SQLite database for improved performance and offline…
v0.1.4v0.1.4 - Documentation Enhancement · 12 Jan 2026Changed Enhanced documentation for `list_tasks` function parameters with improved docstrings Clarified filtering capabilities and default behavior for status, priority, urgency, tags, assignee, due_before, due_after, and page parameters
v0.1.3v0.1.3 - Type annotations improvement · 12 Jan 2026Changed Updated type annotations in `list_tasks` function for improved clarity

README

todo-list-mcp

Todo List MCP Server

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

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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Todo List MCP

How do I install Todo List MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Todo List MCP safe to use with an AI agent?

Its trust score is 54 out of 100 (fair). It passes 2 of the 3 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Todo List MCP still maintained?

The last commit was 8 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.