Advertise
MCP.so
Sign In
M

MCP Tasks

@flesler

Repository

Basic information

Category

AI & Agents

Transports

stdio

Author

flesler

Submitted by

Ariel Flesler

About MCP Tasks

A comprehensive and efficient Model Context Protocol (MCP) server for task management that works seamlessly with Claude, Cursor, and other MCP clients. Designed to minimize tool confusion and maximize LLM budget efficiency while providing powerful search, filtering, and organizat

#mcp#task#management#llm#model-context-protocol#ai#claude#cursor#todo#productivity

MCP Tasks config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-tasks": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-tasks"
      ]
    }
  }
}

MCP Tasks tools

5

Initializes a source from a file path. It must be absolute. Creates file if it does not exist. Returns the source ID for further use

Search tasks from specific statuses with optional text & ID filtering

Add new tasks with a specific status. It's faster and cheaper if you use this in batch, add all at once

Update tasks by ID to a different status. It's faster and cheaper if you use this in batch, update all at once

Get count of tasks in each status and the work-in-progress tasks

Overview

What is MCP Tasks?

MCP Tasks is a Model Context Protocol server for task management, designed to work with Claude, Cursor, and other MCP clients. It minimizes tool confusion and maximizes LLM budget efficiency by providing only five tools, batch operations, and smart defaults. It supports Markdown, JSON, and YAML task files and offers powerful search, filtering, and organization capabilities.

How to use MCP Tasks?

Install via npx (npx -y mcp-tasks) or Docker (docker run --rm -i flesler/mcp-tasks). Add the configuration to your MCP client (e.g., Cursor's mcp.json or Claude Desktop's claude_desktop_config.json). The server provides five tools: tasks_setup, tasks_search, tasks_add, tasks_update, and tasks_summary. Use environment variables to customize workflow statuses, transport mode, auto-WIP behavior, and more. A CLI is also available for quick task management without an AI client.

Key features of MCP Tasks

  • Ultra‑efficient design with only five tools to reduce AI confusion
  • Budget‑optimized with batch operations and smart defaults
  • Multi‑format support: Markdown, JSON, and YAML task files
  • Powerful case‑insensitive text/status filtering with OR logic
  • Auto‑WIP management that automatically limits work in progress
  • Ultra‑safe: AI cannot rewrite or delete tasks without explicit configuration

Use cases of MCP Tasks

  • Track project tasks and subtasks in a human-readable Markdown file
  • Manage customizable workflow states (To Do, In Progress, Done, etc.)
  • Integrate task management directly into AI-assisted coding sessions
  • Quickly add, search, and update tasks via CLI without interrupting AI operations
  • Maintain a structured task list that persists across sessions and tools

Frequently asked questions

1

What file formats does MCP Tasks support?

Markdown (`.md`), JSON (`.json`), and YAML (`.yml`) are supported. The format is auto‑detected from the file extension. Markdown is recommended for human readability.

2

How does auto‑WIP management work?

When `AUTO_WIP` is enabled (default), if a task is moved to the WIP status, all other WIP tasks are moved to To Do. If no WIP task exists, the first To Do task is moved to WIP. This can be disabled by setting `AUTO_WIP=false`.

3

Can the AI delete my tasks?

By default, AI tools can only add and move tasks; they cannot rewrite or delete them. Deletion can be enabled through configuration (e.g., setting `KEEP_DELETED=false` or allowing the `tasks_update` tool to use the “Deleted” status).

4

What transport modes are available?

The server supports `stdio` (default) and `http` transport. Set the `TRANSPORT` environment variable to `http` and optionally change the `PORT` (default 4680) for remote access.

5

How do I add tasks manually while the AI is working?

Use the CLI from a separate terminal: `npx mcp-tasks add "Your task text" "To Do" 0`. This safely adds tasks without interfering with the AI’s use of the tools.

Comments

More AI & Agents MCP servers

Poly-Glot AI Workspace

hmoses

1,000+ fully localized prompt templates across 40+ categories. Compare Mode — send the same prompt to up to 9 AI providers (ChatGPT, Claude, Gemini, Grok, Groq, Copilot, Mistral, Perplexity, DuckDuckGo AI) and compare an

KissCode

NickSF189

KissCode is the world's first relationship network where AI agents and people meet. Connect your agent over MCP: it gets a profile, meets other agents and real people, chats, sends virtual gifts, goes on dinner and movie

OpenZiti / LLM-Gateway

openziti

NetFoundry LLM Gateway is an OpenAI-compatible API proxy that routes requests across multiple LLM providers using zero-trust networking. Zero trust LLM gateway. OpenAI-compatible proxy with semantic routing and load bala

93

OpenZiti MCP Gateway

openziti

NetFoundry MCP Gateway enables secure, isolated access to Model Context Protocol (MCP) tools across distributed systems without exposing public endpoints. Zero trust gateway for MCP servers. Aggregate, filter, and secure

48

Atwork

Atwork Team

Connect Atwork to Claude, ChatGPT, Cursor or any MCP client and work with your real data: ask what is overdue, total a sheet by any field, add tasks, update rows, post comments and draft pages. The assistant acts as you

Advertise