TaskFlow - Universal Task Management MCP Server with GitHub Copilot Integration. Works with Laravel, Node.js, Python, React, Vue, Angular, .NET, Go, Rust, and any project type.
npm install @ptnghia/taskflow-mcp


> Universal Task Management for Any Project
A Model Context Protocol (MCP) server that provides automated task management with GitHub Copilot integration. Control your entire workflow using natural language - no CLI commands needed.
Works with: Laravel, Node.js, Python, React, Vue, Angular, .NET, Go, Rust, and any project type!
- ๐ค GitHub Copilot Integration - Control everything via natural language chat
- ๐ Multilingual Support - English and Vietnamese (Tiแบฟng Viแปt)
- ๐ฏ Auto-generated Copilot Instructions - Zero configuration, ready immediately after setup
- ๐ Smart Task Management - Create, track, and complete tasks with AI assistance
- ๐ Workflow Automation - Automatic status updates, git commits, and progress tracking
- ๐ฏ Task Dependencies - Track relationships and validate circular dependencies
- ๐ Real-time Dashboard - Statistics, progress metrics, and task overview
- โก High Performance - 99% faster with caching and indexing (tested with 100+ tasks)
- ๐ Git Integration - Auto-commit and push when completing tasks
- ๐ Documentation Generation - Auto-generate changelogs, API docs, and architecture overviews
- ๐๏ธ Architecture Decisions - Record and track ADRs with full-text search
- ๐ Universal Support - Works with any programming language or framework
โ ๏ธ Important: npm version is outdated (v1.0.32). Use GitHub installation for latest v1.10.0:
#### Option 1: Install from GitHub (Recommended - Latest Version)
``bash`
npm install -g https://github.com/ptnghia/TaskFlow.git
#### Option 2: Install from npm (Outdated v1.0.32)
`bash`
npm install -g taskflow-mcpNote: This installs old version with only 18 tools
> Verify your version:
> `bash`
> npm list -g taskflow-mcp
> # Should show: taskflow-mcp@1.10.0 (from GitHub)
> # NOT: taskflow-mcp@1.0.32 (outdated from npm)
>
> Windows Users: If you get "command not found" after installation, you may need to:
> 1. Close and reopen PowerShell/Terminal
> 2. Or restart VS Code
> 3. Or add npm global bin to PATH (see troubleshooting below)
`bash`
cd /path/to/your/project
taskflow init
> Troubleshooting "taskflow command not found": See Common Issues section below.
The wizard will:
- Auto-detect your project type (Laravel, Node.js, React, etc.)
- Select your preferred language (English or Vietnamese)
- Create .plans/ directory structuretaskflow.config.json
- Generate .github/copilot-instructions.md
- Set up task templates
- Auto-create - GitHub Copilot ready immediately!
Add to your project's .vscode/mcp.json:
`json`
{
"servers": {
"taskflow": {
"command": "node",
"args": [
"/usr/local/lib/node_modules/taskflow-mcp/dist/index.js"
],
"env": {
"WORKSPACE_ROOT": "${workspaceFolder}"
}
}
}
}
> Important: Update the path in args based on your installation:/usr/local/lib/node_modules/taskflow-mcp/dist/index.js
> - Linux/macOS global: C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\taskflow-mcp\\dist\\index.js
> - Windows global: ${workspaceFolder}/node_modules/taskflow-mcp/dist/index.js
> - Local install: .vscode-example/mcp.json.example
>
> See for detailed examples and configuration options.
#### Finding Your Installation Path
`bash`Find npm global modules location
npm root -gAppend: /taskflow-mcp/dist/index.js to the output
#### Enabling Advanced Tools (Optional)
To enable all 54 tools (default is 40 core tools), add to env:
`json`
"env": {
"WORKSPACE_ROOT": "${workspaceFolder}",
"TASKFLOW_ENABLE_ADVANCED_TOOLS": "true"
}
This enables 14 additional tools: batch operations, rebuilds, template CRUD, detailed views, and utilities. See TOOLS_ORGANIZATION.md for complete list.
Press Ctrl+Shift+P โ "Developer: Reload Window"
Open GitHub Copilot Chat and try:
``
๐ฌ "List all active tasks"
๐ฌ "Show task statistics"
If you see TaskFlow responding, you're all set! ๐
Control TaskFlow using natural language with GitHub Copilot Chat:
๐ฌ "Create a feature task for User Authentication with high priority"
๐ฌ "Add a bug fix task for login validation issue"
`$3
`
๐ฌ "List all active tasks"
๐ฌ "Show me task #001"
๐ฌ "Start task #002"
๐ฌ "Complete task #002" โ Auto commits & pushes!
`$3
`
๐ฌ "Task #005 depends on task #003"
๐ฌ "Link task #017 as parent of task #015"
๐ฌ "Task #012 is related to task #010"
๐ฌ "Show relationships for task #017 with transitive data"
๐ฌ "Find all tasks related to task #015"
๐ฌ "Validate dependencies for all tasks"
`$3
`
๐ฌ "Show task statistics"
๐ฌ "Generate a changelog for this month"
๐ฌ "Analyze codebase structure"
`$3
`
๐ฌ "Record lesson: TypeScript shebang breaks vitest"
๐ฌ "List all lessons about testing"
๐ฌ "Search lessons for 'circular dependency'"
๐ฌ "Get lessons context for typescript errors"
`$3
`
๐ฌ "Recommend next task to work on"
๐ฌ "Break down task #015 into subtasks"
๐ฌ "Generate insights from all testing lessons"
๐ฌ "Find reusable code snippets in the project"
๐ฌ "Suggest refactoring opportunities"
๐ฌ "Generate test cases for UserController"
๐ฌ "Predict project bottlenecks"
๐ฌ "Estimate completion time for task #020"
๐ฌ "Build knowledge graph of tasks and decisions"
`$3
By default, TaskFlow shows 40 core tools for a clean experience. Enable all 54 tools by adding to
.vscode/mcp.json:`json
"env": {
"WORKSPACE_ROOT": "${workspaceFolder}",
"TASKFLOW_ENABLE_ADVANCED_TOOLS": "true"
}
`Advanced Tools (14):
-
batch-update-tasks - Update multiple tasks at once
- rebuild-index - Rebuild task index
- check-git-status - Check git repository status
- create-project-vision - Create project vision document
- sync-todo-list - Sync todo list with tasks
- generate-documentation - Generate project documentation
- get-decision - Get detailed ADR content
- get-lesson - Get detailed lesson content
- get-lessons-context - Get context from lessons
- find-related-tasks - Find related tasks
- create-custom-template - Create custom task template
- delete-custom-template - Delete custom template
- validate-step - Alias for mark-step
- taskflow-mark - Alias for mark-step๐ See
TOOLS_ORGANIZATION.md for complete documentation.๐ฏ Key Benefits
- โฑ๏ธ Save Time - Automate repetitive task operations
- ๐ง Stay Focused - Natural language interface, no context switching
- ๐ Track Progress - Real-time statistics and visualization
- ๐ค Collaborate - Clear task structure for team coordination
- ๐ Never Lose Work - Automatic git integration and backups
๐ Documentation
$3
- 54 MCP Tools - Complete task lifecycle management with smart organization
- 40 Core Tools (always enabled) - Essential features for daily workflow
- 13 Task Management tools (create, list, get, search, start, complete, etc.)
- 5 Context & Vision tools (dashboard, stats, project vision, analyze codebase)
- 3 Architecture Decision tools (record, list, search)
- 3 Lessons Learned tools (record, list, search)
- 3 Task Relationship tools (link, unlink, get relationships)
- 2 Template tools (list, get content)
- 3 AI Smart Recommendations ๐ค (recommend next task, suggest breakdown, lesson insights)
- 3 Code Intelligence ๐ง (code snippets, refactoring suggestions, test generation)
- 3 Predictive Analytics ๐ฎ (bottleneck prediction, time estimation, knowledge graph)
- 14 Advanced Tools (optional) - Enable with
TASKFLOW_ENABLE_ADVANCED_TOOLS=true
- Batch operations, rebuilds, template CRUD, detailed views, aliases
- See TOOLS_ORGANIZATION.md for complete list$3
| Type | Language | Auto-Detected From |
|------|----------|-------------------|
| Laravel | PHP |
composer.json + artisan |
| Node.js | JavaScript/TypeScript | package.json |
| Python | Python | requirements.txt, pyproject.toml |
| React | JavaScript/TypeScript | package.json with React |
| Vue | JavaScript/TypeScript | package.json with Vue |
| Angular | TypeScript | angular.json |
| .NET | C# | .csproj, .sln |
| Go | Go | go.mod |
| Rust | Rust | Cargo.toml |
| Generic | Any | Fallback for other projects |$3
TaskFlow uses
taskflow.config.json for project-specific settings. See taskflow.config.json.example for a complete template.Example configuration:
`json
{
"project": {
"name": "my-app",
"type": "nodejs",
"language": "TypeScript"
},
"workflow": {
"statuses": ["Not Started", "In Progress", "Completed"],
"priorities": ["High", "Medium", "Low"]
},
"git": {
"enabled": true,
"autoCommit": true,
"autoPush": true
}
}
`๐ง Requirements
- Node.js 18+
- VS Code with GitHub Copilot extension
- Git (optional, for auto-commit feature)
๐ Examples
See
.plans-example/ directory for:
- Task structure examples
- Template files (feature, bugfix, refactor)
- Directory organization guide๐ Troubleshooting
$3
1. Check MCP is enabled:
- Settings โ search "mcp"
- Ensure
github.copilot.chat.mcp.enabled is true2. Verify correct path:
- Check
.vscode/mcp.json points to correct index.js location
- Use npm root -g to find global modules path
- Windows: Use double backslashes \\ in paths3. Rebuild if needed:
`bash
cd /path/to/TaskFlow
npm run build
`4. Check output panel:
-
Ctrl+Shift+U โ "GitHub Copilot Chat - MCP"
- Look for error messages5. Reload VS Code:
-
Ctrl+Shift+P โ "Developer: Reload Window"
- MCP changes require reload$3
"taskflow command not found" or "taskflow is not recognized"
After installing globally, the command might not be available immediately. Try these solutions:
1. Close and reopen your terminal/PowerShell
`bash
# Close terminal and open new one, then try:
taskflow init
`2. Check if npm global bin is in PATH
`bash
# Check npm global bin path:
npm bin -g
# Windows: C:\Users\YourUsername\AppData\Roaming\npm
# Linux/macOS: /usr/local/bin
`3. Add npm global bin to PATH (Windows)
- Press
Win + X โ System โ Advanced system settings
- Environment Variables โ Edit PATH
- Add: C:\Users\YourUsername\AppData\Roaming\npm
- Restart terminal4. Use npx instead (no PATH configuration needed)
`bash
npx taskflow-mcp init
`5. Manual setup without taskflow command
`bash
# Create directory structure manually:
mkdir .plans .plans/active .plans/backlog .plans/completed
mkdir .plans/decisions .plans/lessons
mkdir .github
# Copy config from repository:
# Download taskflow.config.json.example and .github/copilot-instructions.md
# from: https://github.com/ptnghia/TaskFlow
`"Tool does not have a description" warnings
You installed the outdated npm version (v1.0.32). Install from GitHub instead:
`bash
Uninstall old version
npm uninstall -g taskflow-mcp
npm cache clean --forceInstall latest from GitHub
npm install -g https://github.com/ptnghia/TaskFlow.gitVerify version
npm list -g taskflow-mcp # Should show 1.10.0
`Then update
.vscode/mcp.json path (run npm root -g to find it) and reload VS Code."Cannot find module"
- Path in
.vscode/mcp.json is incorrect
- Run npm root -g and verify path
- On Windows, use absolute path with \\"No tools available"
- MCP not enabled in settings
- Check
github.copilot.chat.mcp.enabled is true
- Restart VS Code after enabling"WORKSPACE_ROOT not set"
- Add
"WORKSPACE_ROOT": "${workspaceFolder}" to env
- Reload VS Code after addingAdvanced tools not showing
- Add
"TASKFLOW_ENABLE_ADVANCED_TOOLS": "true" to env
- Reload VS Code
- Verify with: ๐ฌ "What tools are available?"$3
- ๐ Setup Issues? See SETUP_GUIDE.md for detailed troubleshooting
- ๐ Check GitHub Issues
- ๐ See VERSION.md for detailed changelog
- ๐ Review example files in
.plans-example/ and .vscode-example/`Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
MIT License - see LICENSE file for details.
If you find TaskFlow useful, please give it a star on GitHub! โญ
---
TaskFlow MCP - Making development workflow smarter, one task at a time.
Version: 1.10.0 | Author: Pham Thanh Nghia | License: MIT