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.

Quick Start • Documentation • MCP Tools

🚀 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

Related MCP server: TickTick MCP Server

✨ 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

Task Master - Simplified. Efficient. Pure MCP.

⭐ Star this repo if you find it useful!