Task Master in Claude Code: your AI project manager in the terminal in 5 minutes, Quentin IA Marketing

You know the moment a project kicks off and you spend two days breaking down the work before writing a single line. Task Master automates that scoping. It is an AI-driven task management system (more than 25,000 stars on GitHub): you hand it a brief, it splits it into structured tasks with their dependencies, tells you where to start, and helps you execute.

Wired in as an MCP server inside Claude Code, it becomes a native command you drive in plain language, without leaving your terminal.

Most tutorials install it in Cursor. If you already live in Claude Code, here is the direct version, no API key, up and running in five minutes.

Claude AI Lab

The Claude AI Lab is my Skool community where I share my Claude systems and the more advanced modules. Entry is free.

Join the Lab →

✅What you need

Claude Code installed. An active session is enough, claude --version should return a number.

Node.js 18 or higher, check with node --version.

An auth method. Claude Pro or Max (recommended, zero API key), or an Anthropic API key.

Why Claude Code over Cursor

⚡ 3 wins

If you already live in your terminal, the Claude Code install spares you an extra layer of tooling. Four concrete reasons.

🔑

Zero API key to manage

With Claude Pro or Max, your Claude Code session is enough. No extra Anthropic Console billing.

⌨️

Pure terminal workflow

You stay in tmux, vim, iTerm or Ghostty. No switching to a graphical interface.

🔗

In sync with your other MCPs

If you already run GitHub, Notion, Linear or Stripe as MCP, Task Master sits alongside them cleanly.

🪝

Native Claude Code hooks

You wire PostToolUse, Stop and other handlers straight onto Task Master actions.

Verify your prerequisites

⌨️ terminal

Two minutes of checks before you install.

# Claude Code installed?
claude --version
# if missing:
npm install -g @anthropic-ai/claude-code
claude login

# Node 18 minimum?
node --version
# if below:
nvm install 20
nvm use 20

For auth, two options: your Claude Pro or Max session (nothing to do, the recommended option), or an Anthropic API key from console.anthropic.com, under Settings then API Keys.

Security

Never put your API key in a file committed to Git. Bots scan GitHub continuously for exposed keys to drain your credit.

Install Task Master

⚡ one command

A single command in your terminal.

claude mcp add taskmaster-ai -- npx -y task-master-ai

Claude Code wires Task Master in as an MCP server for the current project. To make it available across all your projects, add --scope user.

claude mcp add taskmaster-ai --scope user -- npx -y task-master-ai

Check that it took.

claude mcp list

You should see taskmaster-ai in the list. If so, move on.

Connect your Claude session

🔑 zero API key

Launch Claude Code in your project with claude, then type, in plain language:

"Change the main model to claude-code/sonnet"

Task Master understands it should use your existing Claude Code session instead of reaching for an external API key. You spend your Pro or Max subscription, and you pay zero extra. For research, add:

"Change the research model to claude-code/opus"

The right setup

Sonnet to generate tasks, Opus for research: the best quality to speed ratio. Opus is slower but far sharper on deep analysis.

No Pro or Max? Add an API key in the env section of taskmaster-ai, inside ~/.claude.json, then restart Claude Code.

{
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": { "ANTHROPIC_API_KEY": "your_key_here" }
    }
  }
}

Optimise the context

🎛️ tool modes

By default, Task Master loads 36 tools, around 21,000 tokens tied up in your context at all times. For normal use, that is too much: that is context window you lose for your code. Switch to core mode, seven tools, around 5,000 tokens.

claude mcp remove taskmaster-ai
claude mcp add taskmaster-ai --scope user \
  --env TASK_MASTER_TOOLS="core" \
  -- npx -y task-master-ai@latest

The four available modes.

🟢

core or lean

7 tools, ~5,000 tokens. Recommended for most people.

🔵

standard

15 tools, ~10,000 tokens. Daily use, good middle ground.

⚪

all (default)

36 tools, ~21,000 tokens. Wide context, you want everything.

🎚️

custom

You pick your tools by name. Variable tokens.

In custom, you list the tools you want, for example --env TASK_MASTER_TOOLS="get_tasks,next_task,set_task_status,parse_prd,expand_task".

Your first project end-to-end

🚀 5 steps

Task Master installed and connected, here is the full loop on a real project.

Create a project folder and launch Claude inside it: mkdir my-project, cd my-project, claude.

Initialise Task Master. In the session: "Initialize taskmaster-ai in my project". It creates a .taskmaster/ folder with docs, tasks and templates.

Write a minimal PRD. "Create a PRD at .taskmaster/docs/prd.txt for [describe your project in 5 to 10 lines: goal, technical constraints, success criteria, out of scope]". Claude drafts it, you review and adjust.

Generate the tasks. "Parse my PRD at .taskmaster/docs/prd.txt". In 30 to 60 seconds: 10 to 30 tasks, their dependencies, complexity and priority, in .taskmaster/tasks/tasks.json.

Execute. "What's the next task I should work on?", then "Help me implement task 1", then "Mark task 1 as done". Dependent tasks unlock, you keep moving.

The seven commands that cover 95% of the usage.

🟢

Initialise

"Initialize taskmaster-ai in my project"

📝

Generate the tasks

"Parse my PRD at .taskmaster/docs/prd.txt"

📋

See all tasks

"Show me all the tasks"

➡️

Next task

"What's the next task I should work on?"

🔎

Task detail

"Show me task 3"

⚙️

Implement

"Help me implement task 3"

✅

Mark done

"Mark task 3 as done"

What to keep in mind

🎛️

Token cost

Without core mode, Task Master ties up around 21,000 tokens at all times. With Pro or Max you pay nothing, but your context window is heavier. Switch to core as soon as you are comfortable.

📄

It all rides on the PRD

Task quality depends 80% on PRD quality. Vague PRD, unusable tasks.

👥

No native collaboration

Task Master runs on your machine. To work as a team you commit .taskmaster/ to Git, but AI sessions do not sync between members.

⚖️

License

MIT plus Commons Clause. Commercial use and modification allowed, but no reselling Task Master as a service as is.

The takeaway

The real lever is not the tool, it is the loop: scope a clear brief, turn it into dependent tasks, execute without losing the thread. Task Master industrialises that scoping right in your terminal, where you already code.