A task master MCP server for AI-driven development in VS Code by RBuildAI
npm install taskmaster-rbuildai-mcpA task master MCP (Model Context Protocol) server for AI-driven development in VS Code, Cursor, and other MCP-compatible editors.

- 📋 Task Management: Create, update, list, and organize tasks
- 🎯 Subtasks: Break down complex tasks into manageable subtasks
- 📊 Status Tracking: Track progress with status updates (pending, in-progress, done, blocked, deferred)
- 🏷️ Priority Levels: Organize by priority (high, medium, low)
- 🔗 Dependencies: Define task dependencies
- 💾 JSON Storage: Simple file-based storage in .taskmaster/tasks.json
- 🤖 AI-Ready: Designed to work seamlessly with GitHub Copilot, Claude, and other AI assistants
Add to your VS Code MCP configuration at .vscode/mcp.json in your project:
``json`
{
"servers": {
"taskmaster": {
"command": "npx",
"args": ["-y", "taskmaster-rbuildai-mcp"],
"type": "stdio"
}
}
}
`bash`
npm install -g taskmaster-rbuildai-mcp
Then add to .vscode/mcp.json:
`json`
{
"servers": {
"taskmaster": {
"command": "taskmaster-rbuildai-mcp",
"type": "stdio"
}
}
}
Add to ~/.cursor/mcp.json or your project's .cursor/mcp.json:
`json`
{
"mcpServers": {
"taskmaster": {
"command": "npx",
"args": ["-y", "taskmaster-rbuildai-mcp"]
}
}
}
For AI agents (GitHub Copilot, Claude, etc.) to work effectively with TaskMaster, reference the instructions file:
Location: .github/instructions.md in this repository
The instructions file provides:
- ✅ Getting started workflow
- ✅ Task lifecycle management
- ✅ Best practices for AI agents
- ✅ TASKS.md checklist format
- ✅ Example sessions
1. Initialize: taskmaster_init at project starttaskmaster_generate_tasks_md
2. Create tasks: Break down requirements into tasks
3. Generate checklist: for human-readable viewtaskmaster_next_task
4. Work loop: → work → taskmaster_set_status → repeattaskmaster_stats
5. Track progress: to see completion
| Tool | Description |
| ------------------------------ | -------------------------------------------- |
| taskmaster_init | Initialize TaskMaster in a project |taskmaster_get_tasks
| | Get all tasks with optional filtering |taskmaster_get_task
| | Get a specific task by ID |taskmaster_create_task
| | Create a new task |taskmaster_update_task
| | Update an existing task |taskmaster_delete_task
| | Delete a task |taskmaster_set_status
| | Update task status |taskmaster_add_subtask
| | Add a subtask to a task |taskmaster_next_task
| | Get the next task to work on |taskmaster_stats
| | Get project statistics |taskmaster_generate_tasks_md
| | Generate a human-readable TASKS.md checklist |taskmaster_parse_prd
| | Parse requirements/PRD files to create tasks |taskmaster_bulk_status
| | Update multiple task statuses at once |
TaskMaster can generate a human-readable TASKS.md file that serves as a visual checklist:
`markdownProject Tasks
| Status | Count |
| -------------- | ----- |
| ✅ Done | 2 |
| 🔄 In Progress | 1 |
| ⏳ Pending | 3 |
| Total | 6 |
Completion: 33%
---
- [x] Set up project structure (#1)
- [ ] 🔄 Implement authentication (#2)
- [x] Set up OAuth (#2.1)
- [ ] Add JWT tokens (#2.2)
- [ ] Add user profile page (#3)
`
Generate this file anytime using taskmaster_generate_tasks_md.
Tasks are stored in .taskmaster/tasks.json:
`json`
{
"version": "1.0.0",
"projectName": "My Project",
"tasks": [
{
"id": "1",
"title": "Implement authentication",
"description": "Add user authentication system",
"status": "pending",
"priority": "high",
"dependencies": [],
"subtasks": [
{
"id": "1",
"title": "Set up OAuth",
"status": "pending"
}
],
"details": "Implementation notes here...",
"testStrategy": "How to verify this task...",
"createdAt": "2026-01-13T10:00:00.000Z",
"updatedAt": "2026-01-13T10:00:00.000Z"
}
],
"lastUpdated": "2026-01-13T10:00:00.000Z"
}
Once configured, interact through your AI assistant:
`
Initialize taskmaster in this project
Create a task to implement user authentication with high priority
Show me all pending tasks
What's the next task I should work on?
Mark task 1 as in-progress
Add a subtask to task 1: "Set up database schema"
`
| Status | Description |
| ------------- | ------------------------------------- |
| pending | Task not yet started |in-progress
| | Currently being worked on |done
| | Completed |blocked
| | Cannot proceed (waiting on something) |deferred
| | Postponed for later |
| Priority | Description |
| -------- | ------------------------- |
| high | Urgent/critical tasks |medium
| | Normal priority (default) |low
| | Can wait |
`bashClone the repo
git clone https://github.com/RagnarPitla/TaskMaster-rbuildai-mcp.git
cd TaskMaster-rbuildai-mcp
Contributions are welcome! Please feel free to submit a Pull Request.
MIT
RBuildAI - GitHub