Task orchestrator
Model Context Protocol (MCP) server for comprehensive task and feature management, providing AI assistants with a structured, context-efficient way to interact with project data.
42 Tools
Add to Docker Desktop
Version 4.43 or later needs to be installed to add the server automatically
Tools
| Name | Description |
|---|---|
create_dependency | Creates a new task dependency with validation for task existence, cycle detection, and duplicate prevention. Dependencies represent relationships between tasks that can affect execution planning and workflow management. This tool ensures data integrity by validating all aspects before creation. Example successful response: { "success": true, "message": "Dependency created successfully", "data": { "id": "550e8400-e29b-41d4-a716-446655440000", "fromTaskId": "661e8511-f30c-41d4-a716-557788990000", "toTaskId": "772f9622-g41d-52e5-b827-668899101111", "type": "BLOCKS", "createdAt": "2025-05-10T14:30:00Z" } } Common error responses: - VALIDATION_ERROR: When provided parameters fail validation - RESOURCE_NOT_FOUND: When one or both tasks don't exist - CONFLICT_ERROR: When the dependency would create a cycle or already exists - DATABASE_ERROR: When there's an issue storing the dependency - INTERNAL_ERROR: For unexpected system errors |
create_task | Creates a new task with the specified properties. ## Purpose Tasks are the primary work items in the system and can be organized into Features. Each task has basic metadata (title, status, etc.) and can have Sections for detailed content. ## Template Integration RECOMMENDED: Apply templates at creation time using templateIds parameter for consistent documentation structure. Use `list_templates` first to find appropriate templates. Template application creates standardized sections automatically: - Use single-item array for one template: ["template-uuid"] - Use multiple templates for comprehensive coverage: ["uuid1", "uuid2"] - Templates are applied in order, with later templates' sections appearing after earlier ones ## Best Practices - Use descriptive titles that clearly indicate the work to be done - Write comprehensive summaries with acceptance criteria when helpful - Set appropriate complexity ratings (1=trivial, 10=highly complex) - Use consistent tagging conventions (e.g., "task-type-feature", "task-type-bug") - Associate with features when the task is part of larger functionality - Apply templates that match the work type (implementation, testing, documentation) ## Entity Relationships - Tasks can belong to Features (use featureId to establish relationship) - Tasks can belong to Projects (use projectId for top-level organization) - Use dependencies to link related tasks (see create_dependency tool) ## Workflow Integration Tasks integrate with the complete project management workflow: 1. Start with get_overview to understand current work 2. Create task with appropriate templates and metadata 3. Use add_section or bulk_create_sections for additional content 4. Update status as work progresses (pending → in_progress → completed) 5. Create dependencies between related tasks Example successful response: { "success": true, "message": "Task created successfully with 2 template(s) applied, creating 6 section(s)", "data": { "id": "550e8400-e29b-41d4-a716-446655440000", "title": "Implement OAuth Authentication API", "summary": "Create secure API endpoints for OAuth 2.0 authentication with JWT tokens", "status": "pending", "priority": "high", "complexity": 8, "createdAt": "2025-05-10T14:30:00Z", "modifiedAt": "2025-05-10T14:30:00Z", "featureId": "661e8511-f30c-41d4-a716-557788990000", "tags": ["task-type-feature", "oauth", "authentication", "api", "security"], "appliedTemplates": [ { "templateId": "technical-approach-uuid", "sectionsCreated": 3 }, { "templateId": "implementation-workflow-uuid", "sectionsCreated": 3 } ] } } For task creation patterns and best practices, see: task-orchestrator://guidelines/task-management Common error responses: - VALIDATION_ERROR: When provided parameters fail validation (empty title/summary, invalid UUIDs) - RESOURCE_NOT_FOUND: When specified featureId, projectId, or templateIds don't exist - DATABASE_ERROR: When there's an issue storing the task or applying templates - INTERNAL_ERROR: For unexpected system errors |
search_tasks | Searches for tasks based on various criteria. ## Purpose Provides flexible task discovery and filtering capabilities for project management, work planning, and task analysis. Essential for finding specific tasks or analyzing work patterns across the project. ## Search Strategy Guidelines **Start Broad, Narrow Down**: 1. Begin with no parameters to see all tasks 2. Add status filter to focus on specific work states 3. Add priority filter for urgency-based searches 4. Use tag filters for domain-specific searches 5. Combine multiple filters for precise targeting **Common Search Patterns**: **Finding Work to Do**: ```json { "status": "pending", "priority": "high", "sortBy": "priority", "sortDirection": "desc" } ``` **Reviewing In-Progress Work**: ```json { "status": "in-progress", "sortBy": "modifiedAt", "sortDirection": "desc" } ``` **Finding Feature-Specific Tasks**: ```json { "featureId": "feature-uuid", "sortBy": "complexity", "sortDirection": "asc" } ``` **Tag-Based Searches** (using consistent tagging conventions): ```json { "tag": "task-type-bug", "priority": "high" } ``` **Text-Based Discovery**: ```json { "query": "authentication oauth", "sortBy": "modifiedAt" } ``` ## Filter Combinations for Different Use Cases **Sprint Planning**: - Filter by status="pending" and priority="high" or "medium" - Sort by complexity to group similar-sized work - Use pagination to handle large backlogs **Bug Triage**: - Filter by tag="task-type-bug" - Sort by priority and modifiedAt - Review high priority bugs first **Feature Development**: - Filter by featureId to see all related tasks - Sort by status to see progression - Check complexity distribution for estimation **Technical Debt Management**: - Filter by tag="technical-debt" or tag="refactoring" - Sort by complexity to tackle manageable items - Combine with priority for impact assessment ## Pagination Best Practices **Default Behavior**: No parameters returns all tasks, newest first, 20 per page **Efficiency Guidelines**: - Use limit=5-10 for quick overviews - Use limit=50-100 for comprehensive analysis - Use offset for paging through large result sets - Sort by modifiedAt for recent activity - Sort by priority for work planning - Sort by complexity for estimation analysis ## Integration with Other Tools **After Search Results**: - Use `get_task` with includeSections=true for detailed task info - Use `update_task` to modify status, priority, or assignments - Use `create_dependency` to link related tasks found in search - Use `get_feature` to understand feature context for tasks **Complement get_overview**: - get_overview: High-level project state and hierarchical view - search_tasks: Detailed filtering and analysis of specific task subsets ## Context Efficiency Features **Lightweight Results**: Returns essential metadata without summary, full content, or sections **Excluded Fields**: Summary field excluded from search results (use get_task to retrieve) **Paginated Results**: Controls token usage for large datasets **Flexible Sorting**: Enables different analytical perspectives **Multiple Filters**: Precise targeting reduces noise Example successful response: { "success": true, "message": "Found 12 tasks", "data": { "items": [ { "id": "550e8400-e29b-41d4-a716-446655440000", "title": "Implement OAuth Authentication API", "status": "in-progress", "priority": "high", "complexity": 8, "createdAt": "2025-05-10T14:30:00Z", "modifiedAt": "2025-05-10T15:45:00Z", "featureId": "661e8511-f30c-41d4-a716-557788990000", "tags": ["task-type-feature", "oauth", "authentication", "api", "security"] } ], "pagination": { "page": 1, "pageSize": 20, "totalItems": 12, "totalPages": 1, "hasNext": false, "hasPrevious": false } } } Common error responses: - VALIDATION_ERROR: When provided parameters fail validation (invalid status, priority, UUID) - DATABASE_ERROR: When there's an issue searching for tasks - INTERNAL_ERROR: For unexpected system errors - INTERNAL_ERROR: For unexpected system errors |
Manual installation
You can install the MCP server using:
Installation for