todo-md-mcp

Todo Md MCP Server

todo-md-mcp gives AI assistants tools to manage tasks in a Markdown file through MCP. Users can list, add, revise, delete, and clear completed tasks, with persistent identifiers tracking individual entries.

Server facts

todo-md-mcp

Project

License
Not specified
Category
Productivity

Tech

Runtime / language
Not specified
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
6
Last commit
Data as of

Overview

A Markdown task list is the storage layer for todo-md-mcp, which connects AI assistants to checkbox-based todos through MCP. Its list_todos tool returns the task collection as JSON alongside summary statistics. New entries are created through add_todo with task text and receive generated identifiers. For existing entries, update_todo accepts an identifier and can change the wording, completion state, or both. The file keeps each identifier in a hidden HTML comment, while task status uses Markdown checkboxes.

Cleanup is split between deleting a particular entry with delete_todo and removing finished entries together with clear_completed, which reports how many were cleared. By default, the server creates todo.md in its working directory. The TODO_FILE_PATH environment variable lets users choose another location; the containing directory must already exist and permit writing. This matters for Claude Desktop configurations where the working directory may not be writable. The project documents Claude Desktop integration, uses stdio transport, and requires Node.js 18 or later plus an MCP-compatible client.

todo-md-mcp setup notes

  • todo-md-mcp records stdio only; confirm a network transport upstream before planning remote access.
  • todo-md-mcp has no recorded license; confirm reuse terms in its repository.

Related MCP servers