Overview
mcp-tasks is an MCP server that provides an efficient, multi-format task management workflow across Markdown (.md), JSON (.json), and YAML (.yml) files. Designed to minimize tool confusion, it relies on a minimal toolset (five tools) to maximize LLM budget efficiency while delivering powerful search, filtering, and organization capabilities. It supports managing multiple task files simultaneously (multi-source), with real-time updates that persist automatically to the chosen format. Tasks can be searched using case-insensitive text and status filters, with OR logic and ID-based lookups for precise retrieval. The system organizes work using customizable workflow states (e.g., Backlog, To Do, In Progress, Done) and provides 0-based insertion for easy task ordering. It includes WIP (work-in-progress) management, duplicate prevention, and a strong emphasis on type-safety through TypeScript and Zod validation. It also offers an ultra-safe mode where AI cannot rewrite or delete tasks (unless enabled) and an optional Reminders section that the AI can maintain. The server supports NPX, Docker, and HTTP/stdio transports, plus environment-variable driven configuration and a CLI for quick task management and automation.
Features
Ultra-efficient design
Minimal tool count (5 tools) to reduce AI confusion and streamline workflows.
Budget-optimized
Batch operations, smart defaults and auto-operations minimize LLM API calls.
Multi-format support
Supports Markdown (.md), JSON (.json), and YAML (.yml) task files.
Powerful search
Case-insensitive text and status filtering with OR logic and ID-based lookup.
Smart organization
Status-based filtering with customizable workflow states for task workflows.
Position-based indexing
0-based insertion for easy task ordering.
Multi-source support
Manage multiple task files simultaneously.
Real-time updates
Changes persist automatically to the chosen task file format.
