mcp-tasks

Overview

MCP Tasks is an efficient task management server designed to minimize AI confusion and maximize budget efficiency. It provides powerful search, filtering, and organization capabilities with just 5 core tools. The server supports multiple file formats, includes auto WIP management, duplicate prevention, and maintains ultra-safe operations where AI can't accidentally delete tasks unless explicitly enabled. Its TypeScript implementation includes Zod validation for type safety and offers both stdio and HTTP transport options.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• tasks_setupsource_path, workspace?

  Initialize a task file (creates if missing, supports .md, .json, .yml)

  Try:Set up a task file at tasks.mdTry:Initialize a task management system for my project
• tasks_searchsource_id, statuses?, terms?, ids?

  Search tasks with filtering by text/status/IDs

  Try:Find tasks related to authenticationTry:Show all tasks in 'To Do' statusTry:Search for tasks with IDs 'm3Qw' and 'p9Lx'
• tasks_addsource_id, texts[], status, index?

  Add new tasks to a specific status at an optional position

  Try:Add a new task 'Write user registration' to 'To Do'Try:Add multiple tasks to the backlog at the top
• tasks_updatesource_id, ids[], status, index?

  Update task status or position by their IDs

  Try:Mark tasks m3Qw and p9Lx as 'Done'Try:Move task to 'In Progress' at the top of the list
• tasks_summarysource_id

  Get task counts and work-in-progress overview

  Try:Show me a summary of all tasksTry:Get status counts for my task list

Comparable tools

Installation

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

{
  "mcpServers": {
    "mcp-tasks": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "flesler/mcp-tasks"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-tasks": {
      "command": "npx",
      "args": ["-y", "mcp-tasks"],
      "env": {
        "STATUS_WIP": "In Progress",
        "STATUS_TODO": "To Do",
        "STATUS_DONE": "Done",
        "AUTO_WIP": "true"
      }
    }
  }
}

FAQ

What file formats are supported?

MCP Tasks supports Markdown (.md), JSON (.json), and YAML (.yml) task files. Format is auto-detected from file extension.

How does AI integration work?

The server provides 5 core tools (setup, search, add, update, summary) that AI can use to manage tasks. Encourage AI use with prompts like 'Use mcp-tasks tools to track our work in path/to/tasks.md'.

Can the AI accidentally delete my tasks?

By default, AI can only add and move tasks. Task deletion is disabled unless you explicitly set KEEP_DELETED=false in environment variables.

Compare mcp-tasks with