Task Master

🎯 Simplified Trello-style task management for MCP - Pure MCP functionality with 11 essential tools for efficient CRUD task management, eliminating complex LLM-dependent features.

<div align="center">

Quick Start • Documentation • MCP Tools

</div>

🚀 Quick Start

Prerequisites

• Node.js 18+
• An MCP client (Claude Desktop, VSCode with MCP extension, etc.)

Installation

1. Clone and build

   git clone https://github.com/yourusername/mcp-task-master
   cd mcp-task-master
   npm install && npm run build
   

2. Configure MCP client

   Add to your MCP client configuration (e.g., ~/.claude/config.json):

   {
     "mcpServers": {
       "task-master": {
         "command": "node",
         "args": ["/path/to/mcp-task-master/dist/index.js"],
         "env": {
           "DATA_DIR": "/path/to/your/task/data"
         }
       }
     }
   }
   

3. Start using

   # List all tasks
   list_tasks --status all
   
   # Create a task (via Dashboard)
   start_dashboard
   

✨ Key Features

• 🎯 Simplified: Reduced from 19 to 11 essential MCP tools (42% reduction)
• ⚡ Pure MCP: No complex LLM dependencies, focusing on true MCP efficiency
• 🌐 Bilingual: Korean/English support
• 📊 Dashboard: Real-time React-based web interface
• 🔄 Trello-style: Intuitive CRUD task management

🛠 MCP Tools (11 Essential Tools)

💼 Core Task Management (7 tools)

• list_tasks - List all tasks by status with Trello-style emojis
• execute_task - Simplified task execution guide
• get_task_detail - View complete task information
• query_task - Search tasks by keywords or ID
• update_task - Modify task content and properties
• delete_task - Remove specific tasks
• clear_all_tasks - Clear all tasks with backup

📊 Dashboard Management (4 tools)

• start_dashboard - Launch React web interface
• stop_dashboard - Stop dashboard server
• status_dashboard - Check server status
• list_dashboard_projects - View registered projects
• add_dashboard_project - Register new projects
• create_tasks_in_project - Create project-specific tasks

📚 Documentation

Task Data Model (Simplified)

interface Task {
  id: string;                    // UUID
  name: string;                  // Task name
  description: string;           // Task description
  notes?: string;               // Additional notes
  status: TaskStatus;           // pending | in_progress | completed | blocked
  dependencies: TaskDependency[]; // Task dependencies
  createdAt: Date;              // Creation date
  updatedAt: Date;              // Last modified
  completedAt?: Date;           // Completion date
  summary?: string;             // Completion summary
  relatedFiles?: RelatedFile[]; // Related files
  agent?: string;              // Assigned agent
}

Environment Variables

# Required
DATA_DIR="/path/to/task/data"

# Optional
LANG="ko"                    # Language (ko/en)
ENABLE_GUI="false"          # Enable web dashboard
WEB_PORT="3000"            # Dashboard port

🎮 Usage Examples

Basic Task Management

# List all tasks
list_tasks --status all

# Search tasks
query_task --query "fix bug" --page 1

# Get task details
get_task_detail --taskId "your-task-id"

# Update task
update_task --taskId "your-task-id" --name "New Task Name"

Dashboard Operations

# Start web dashboard
start_dashboard --port 9998

# Check dashboard status
status_dashboard

# Create project tasks
create_tasks_in_project --projectName "MyProject" --tasks '[{"title":"Task 1", "priority":"High"}]'

🏗 Architecture

src/
├── index.ts                 # MCP server entry point (11 tools)
├── models/taskModel.ts      # Simplified data models & CRUD
├── messages/                # Bilingual message system
│   ├── korean.ts           # Korean messages
│   └── english.ts          # English messages
├── tools/
│   ├── task/              # 7 core task tools
│   └── dashboard/         # 4 dashboard tools
├── types/index.ts          # Simplified type definitions
└── utils/                  # Common utilities

🚀 Performance Improvements

Metric	Before	After	Improvement
MCP Tools	19	11	42% reduction
Code Size	Complex	~49KB removed	Significant
Template Files	140+	Direct messages	Streamlined
Language Support	3 languages	2 languages	Focused
Memory Usage	High	Reduced	LLM system removed

⚡ What Was Removed

Complex LLM-dependent features:

• ❌ plan_task - Complex task planning
• ❌ analyze_task - Codebase analysis
• ❌ split_tasks - Task decomposition (large files)
• ❌ verify_task - Complex quality verification
• ❌ reflect_task - Task retrospection
• ❌ process_thought - Thought processing
• ❌ research_mode - Research mode
• ❌ init_project_rules - Project rules initialization

Simplified data model:

• ❌ implementationGuide - Complex implementation guides
• ❌ verificationCriteria - Quality verification criteria
• ❌ analysisResult - LLM-based analysis results
• ❌ Complex template system (140+ files)

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built for the Model Context Protocol (MCP)
• Inspired by Trello's simplicity and effectiveness
• Focused on pure MCP efficiency without LLM complexity

---

<div align="center">

Task Master - Simplified. Efficient. Pure MCP.

⭐ Star this repo if you find it useful!

</div>