flesler/mcp-tasks

A comprehensive and efficient MCP server for task management with multi-format support (Markdown, JSON, YAML)

47 ★7 forksTypeScriptUpdated 29d ago

What you need to know

An efficient task manager MCP server designed to minimize tool confusion and LLM budget use. Only 5 tools (tasks_setup, tasks_search, tasks_add, tasks_update, tasks_summary) with batch operations, smart defaults, auto-WIP management, and duplicate prevention. Tasks live in auto-created Markdown, JSON, or YAML files (format detected by extension). Ultra-safe by design: the AI can add and move tasks but cannot rewrite or delete them. Includes a CLI (mcp-tasks add/search/update/summary) for humans. Node >= 20, stdio or HTTP transport, Docker image available. MIT.

Install

npx -y mcp-tasks
Docker: fleshler/mcp-tasks (docker run --rm -i)

Key features

✓Minimal 5-tool design to reduce AI confusion
✓Markdown, JSON, and YAML task files (auto-detected)
✓Auto-WIP management and duplicate prevention
✓Position-based indexing and status-based filtering
✓Ultra-safe: AI cannot rewrite or delete tasks
✓CLI for human editing while AI works

Caveats

⚠Node.js 20+ required
⚠Tools rewrite the whole task file; non-task content may be lost - use a dedicated task file

Reviewed 2026-08-11

Topics

aiclaudeclaude-aiclaude-codecursorllmmcpmcp-servermodel-context-protocoltask-managertodo

Stars: 47★
Forks: 7
Language: TypeScript
License: MIT
Created: 2025-07-17
Last push: 2026-08-06