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](#-quick-start) • [Documentation](#-documentation) • [MCP Tools](#-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

1. 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"
         }
       }
     }
   }

1. 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

⚡ 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>