← Back to directory
C

Claude Task Master

Community
An AI-powered task management system that drops into Cursor, Lovable, Windsurf, Roo, and more.
GitHub source repository ↗
★ 28.0k Stars Category · Dev Tools Very popular Source revision c0c98d367c55
47FMRS · D
Reliability
7/20
Security and permissions
8/20
Maintenance
15/20
Documentation
9/20
Setup experience
8/20

Task Master is a feature-rich AI task management MCP server supporting multiple AI providers and editors, offering a complete workflow from PRD to task tracking. Its strengths are easy integration and diverse tools, but its non-official nature, license restrictions, and reliance on external AI services are factors to consider.

Read the FMRS scoring method →

Task Master (task-master-ai) is an AI-driven task management system designed for AI-assisted development, integrating seamlessly with editors like Cursor, Lovable, Windsurf, and Roo. It provides task management tools via MCP, supporting parsing requirements from PRDs, generating task lists, tracking progress, managing dependencies, and leveraging AI for research and loop execution. The system supports multiple AI providers (Anthropic, OpenAI, Google, Perplexity, etc.) and allows optimizing tool loading through environment variables (e.g., TASK_MASTER_TOOLS) to reduce context window usage.

Tools

get_tasks
Get the current list of tasks.
next_task
Get the next task to work on.
get_task
Get details of a single task.
set_task_status
Set task status (e.g., pending, in-progress, done).
update_subtask
Update subtask status.
parse_prd
Parse a PRD and generate a task list.
expand_task
Expand a task into more detailed subtasks.
initialize_project
Initialize the Task Master project structure.
analyze_project_complexity
Analyze project complexity.
expand_all
Expand all tasks.
add_subtask
Add a subtask to a task.
remove_task
Remove a task.
generate
Generate tasks.
add_task
Add a new task.
complexity_report
Generate a complexity report.

Setup

  1. Add the install_config above to your MCP configuration file (e.g., ~/.cursor/mcp.json for Cursor, .vscode/mcp.json for VS Code, etc.).
  2. Replace placeholder API keys with your actual provider keys (at least one is required unless using Claude Code or Codex CLI).
  3. Restart your editor and enable the MCP server.
  4. In your AI chat, run 'Initialize taskmaster-ai in my project' to initialize.
claude_desktop_config.json
{
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
      "args": [
        "-y",
        "task-master-ai"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
        "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
        "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
        "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE",
        "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
        "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"
      }
    }
  }
}

Fit and risk

Best for

  • Product managers and developers who want to manage development tasks directly from AI chat
  • Users of AI editors like Cursor, Windsurf, VS Code
  • Teams needing to automate task generation from requirements documents (PRDs)
  • Developers looking to minimize context window usage and optimize AI tool loading

Not for

  • Traditional project management scenarios without AI assistance
  • Environments without any API key and without Claude Code or Codex CLI installed
  • Users seeking fully offline, dependency-free task management
  • Those who need commercial hosting or want to resell the software (license limitations)

Required permissions

  • Read project files (e.g., PRD documents)
  • Create and modify task files in the project directory (e.g., .taskmaster folder)
  • Execute the task-master-ai package via npx
  • Access external AI APIs (e.g., Anthropic, OpenAI) to generate and analyze tasks

Risks and side effects

  • AI-generated tasks may be inaccurate and require human review
  • Project file data is sent to external AI services, posing potential data leakage risks
  • API keys in config files could be leaked and misused
  • Non-official server with MIT with Commons Clause license; resale or hosting is prohibited
  • Large default toolset (36) may increase context consumption; configuration optimization recommended

Troubleshooting

  1. If `task-master init` doesn't respond, try running `node node_modules/claude-task-master/scripts/init.js` directly
  2. If you see '0 tools enabled' in MCP settings, restart your editor and check API key configuration
  3. Ensure the TASK_MASTER_TOOLS environment variable is set correctly (all, standard, core, etc.)
  4. Check network connectivity to ensure access to AI APIs
  5. Verify write permissions in the project directory

Use cases

Automatically generate task lists from a PRD
Manage development tasks in your IDE via natural language
Track task status, dependencies, and tags
Use AI to research latest technical practices
Collaborate on AI-driven development workflows in teams

Supported clients

Claude DesktopFull support
CursorFull support
WindsurfFull support
VS CodeFull support
Q CLIFull support