RTaskmaster MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RTaskmaster MCP Create a high-priority task for setting up database schema"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
RTaskmaster MCP
A task master MCP (Model Context Protocol) server for AI-driven development in VS Code, Cursor, and other MCP-compatible editors.
Features
📋 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
.rtaskmaster/tasks.json🤖 AI-Ready: Designed to work seamlessly with GitHub Copilot, Claude, and other AI assistants
Related MCP server: Tasks MCP Server
Quick Install for VS Code
Option 1: NPX (Recommended - No Install Required)
Add to your VS Code MCP configuration at .vscode/mcp.json in your project:
{
"servers": {
"rtaskmaster": {
"command": "npx",
"args": ["-y", "rtaskmaster-mcp"],
"type": "stdio"
}
}
}Option 2: Global Install
npm install -g rtaskmaster-mcpThen add to .vscode/mcp.json:
{
"servers": {
"rtaskmaster": {
"command": "rtaskmaster-mcp",
"type": "stdio"
}
}
}Option 3: Cursor IDE
Add to ~/.cursor/mcp.json or your project's .cursor/mcp.json:
{
"mcpServers": {
"rtaskmaster": {
"command": "npx",
"args": ["-y", "rtaskmaster-mcp"]
}
}
}📖 AI Agent Instructions
For AI agents (GitHub Copilot, Claude, etc.) to work effectively with RTaskmaster, 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
Quick Workflow for AI Agents
Initialize:
rtaskmaster_initat project startCreate tasks: Break down requirements into tasks
Generate checklist:
rtaskmaster_generate_tasks_mdfor human-readable viewWork loop:
rtaskmaster_next_task→ work →rtaskmaster_set_status→ repeatTrack progress:
rtaskmaster_statsto see completion
Available MCP Tools
Tool | Description |
| Initialize RTaskmaster in a project |
| Get all tasks with optional filtering |
| Get a specific task by ID |
| Create a new task |
| Update an existing task |
| Delete a task |
| Update task status |
| Add a subtask to a task |
| Get the next task to work on |
| Get project statistics |
| Generate a human-readable TASKS.md checklist |
| Parse requirements/PRD files to create tasks |
| Update multiple task statuses at once |
📋 TASKS.md Checklist File
RTaskmaster can generate a human-readable TASKS.md file that serves as a visual checklist:
# Project Tasks
## 📊 Progress
| Status | Count |
| -------------- | ----- |
| ✅ Done | 2 |
| 🔄 In Progress | 1 |
| ⏳ Pending | 3 |
| **Total** | **6** |
**Completion: 33%**
---
## ✅ Tasks
### 🔴 High Priority
- [x] Set up project structure (#1)
- [ ] 🔄 Implement authentication (#2)
- [x] Set up OAuth (#2.1)
- [ ] Add JWT tokens (#2.2)
### 🟡 Medium Priority
- [ ] Add user profile page (#3)Generate this file anytime using rtaskmaster_generate_tasks_md.
Task Structure
Tasks are stored in .rtaskmaster/tasks.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"
}Usage Examples
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"Task Statuses
Status | Description |
| Task not yet started |
| Currently being worked on |
| Completed |
| Cannot proceed (waiting on something) |
| Postponed for later |
Priority Levels
Priority | Description |
| Urgent/critical tasks |
| Normal priority (default) |
| Can wait |
Development
# Clone the repo
git clone https://github.com/RagnarPitla/RTaskmaster-rbuildai-mcp.git
cd RTaskmaster-rbuildai-mcp
# Install dependencies
npm install
# Build
npm run build
# Watch mode for development
npm run dev
# Test with MCP Inspector
npm run inspectorContributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT
Author
RBuildAI - GitHub
Available Tools
13 toolsrtaskmaster_add_subtaskB
Add a subtask to an existing task.
Inputs: title (required), taskId (required), projectRoot (required), description.
rtaskmaster_bulk_statusB
Update the status of multiple tasks at once.
Inputs: status (required), taskIds (required), projectRoot (required).
rtaskmaster_create_taskC
Create a new task.
Inputs: title (required), projectRoot (required), details, priority, +3 more.
rtaskmaster_delete_taskC
Delete a task.
Inputs: taskId (required), projectRoot (required).
rtaskmaster_generate_tasks_mdA
Generate a human-readable TASKS.md checklist file from the current tasks. Creates or updates the file in the project root.
Inputs: projectRoot (required), includeDetails.
rtaskmaster_get_taskB
Get detailed information about a specific task or subtask.
Inputs: taskId (required), projectRoot (required).
rtaskmaster_get_tasksB
Get all tasks from the project, optionally filtered by status or priority.
Inputs: projectRoot (required), status, priority.
rtaskmaster_initB
Initialize RTaskmaster Task Master in a project. Creates .rtaskmaster directory with tasks.json.
Inputs: projectRoot (required), projectName.
rtaskmaster_next_taskB
Get the next task to work on based on priority and dependencies.
Inputs: projectRoot (required).
rtaskmaster_parse_prdB
Parse a PRD (Product Requirements Document) or README file and create tasks from it. Provide either content directly or a file path.
Inputs: projectRoot (required), content, filePath, defaultPriority.
rtaskmaster_set_statusC
Update the status of a task or subtask.
Inputs: status (required), taskId (required), projectRoot (required).
rtaskmaster_statsB
Get task statistics and project progress.
Inputs: projectRoot (required).
rtaskmaster_update_taskB
Update an existing task.
Inputs: taskId (required), projectRoot (required), title, details, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool has a clearly distinct purpose: create, read, update, delete tasks, manage subtasks, set status, bulk operations, generate reports, parse PRDs, and get next task. No overlaps.
All tools follow the consistent 'rtaskmaster_' prefix with verb_noun pattern in snake_case (e.g., create_task, update_task, set_status), making naming predictable.
13 tools is well-scoped for a task management server, covering initialization, CRUD, status, subtasks, bulk updates, and reporting without being excessive.
Covers full task lifecycle CRUD, status updates, subtasks, bulk operations, and import from PRDs. Minor gap: no explicit dependency management tool, but dependencies are considered in next_task.
Maintenance
Related MCP Connectors
ADHD-friendly task management MCP server for ChaTodo: organize tasks, lists, and priorities.
Task management your AI agents can actually run. One line becomes a context-ready task over MCP.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for Google Tasks: review, plan and tidy your tasks by asking. Deletes always ask first.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAI-driven task management application that operates via MCP, enabling autonomous creation, organization, and execution of tasks with support for subtasks, priorities, and progress tracking.2MIT
- FlicenseNot gradedqualityDmaintenanceA task management MCP server that provides tools to create, list, complete, and delete tasks using pluggable storage backends. It enables users to interact with their task lists through natural language using MCP-compatible clients like Claude Desktop.-
- AlicenseNot gradedqualityDmaintenanceA task management MCP server that allows users to create, list, and organize tasks with priorities, labels, and projects using natural language. It provides a persistent SQLite-backed system for tracking due dates and managing task workflows directly within Claude Code.2MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to interact with the Taskwarrior command-line task management tool. It allows users to list, create, modify, and organize tasks using projects, tags, and annotations through natural language.132MIT