TaskFlow MCP

Overview

TaskFlow MCP is a complete task management solution built on the Model Context Protocol. It helps you:

- Create structured tasks with natural language descriptions
- Track dependencies between related tasks
- Manage workflow with status transitions and prioritization
- Generate project plans from requirement documents
- Analyze task complexity with AI-powered assistance

All features work natively in Cursor IDE without requiring external API keys, leveraging the intelligence of your existing AI environment.

Installation

$3

``bash


Install via npm (globally)

npm install -g @nazk/taskflow-mcp

Or as a dev dependency

npm install --save-dev @nazk/taskflow-mcp
`

⚠️ Requirements
- Node.js 18.0.0+ (20.12.2 LTS recommended)
- Cursor IDE or other MCP-compatible client

$3

`bash


Start TaskFlow MCP server


npx taskflow-mcp
`

The server automatically registers with Cursor IDE when launched.

$3

TaskFlow is optimized for use with Cursor IDE, where it integrates directly with your development workflow. While it implements the standard MCP protocol and may work with other MCP clients, the experience is designed specifically for coding environments.

Tools

TaskFlow exposes the following MCP tools:

| Category | Tool | Description |
|----------|------|-------------|
| Basic | createTask | Create a new task with title, description, and optional metadata |
| | listTasks | List all tasks with optional filtering by status or priority |
| | getNextTask | Determine the next logical task to work on based on dependencies |
| Management | updateTask | Update properties of an existing task |
| | deleteTask | Remove a task from the system |
| | setTaskStatus | Change a task's status (todo, in-progress, review, done) |
| Relations | addDependency | Create a dependency relationship between tasks |
| | removeDependency | Remove a dependency relationship |
| AI-Powered | generateTaskFromPrompt | Create a well-structured task from natural language |
| | analyzeTaskComplexity | Analyze and estimate task difficulty |
| Planning | createProjectPlan | Generate a complete project plan with tasks and dependencies |
| | parsePRD | Extract tasks from a Product Requirements Document |

Resources

TaskFlow also provides MCP resources for data access:

- taskflow://tasks.json - Collection of tasks with pagination
- taskflow://task/{id} - Individual task details
- taskflow://tasks/status/{status} - Tasks filtered by status

Features

$3

TaskFlow provides comprehensive task tracking:

- Multiple Status States: Track progress through todo, in-progress, review, and done stages
- Priority Levels: Assign importance (low, medium, high) to prioritize work
- Subtask Support: Break down complex tasks into smaller, manageable steps
- Dependency Tracking: Establish prerequisites between tasks to ensure proper sequencing

$3

Leverage the power of AI through MCP:

- Natural Language Task Creation: Generate structured tasks from simple descriptions
- Complexity Analysis: Get AI-powered estimates of task difficulty and time requirements
- PRD Parsing: Extract actionable tasks from product requirement documents
- Project Planning: Create comprehensive project plans with logical dependencies

$3

Stay informed of changes:

- Task Change Notifications: Receive updates when task status or properties change
- Dependency Alerts: Get notified when prerequisite tasks are completed

Usage Examples

$3

`javascript
// In Cursor, the AI will handle this for you based on your request
createTask({
title: "Implement user authentication",
description: "Add JWT-based auth with refresh tokens",
priority: "high",
subtasks: [
"Create login endpoint",
"Implement token generation",
"Add refresh token flow"
]
});
`

$3

Simply ask your AI assistant in natural language:

- "Create a task for implementing the checkout feature"
- "Break down the payment processing task into subtasks"
- "Analyze the complexity of the database migration task"
- "Generate a project plan for the mobile app launch"

Project Structure

TaskFlow maintains a clean organization in your project:

`
your-project/
├── tasks/
│ ├── tasks.json # Main task storage
│ ├── task-1.md # Individual task details
│ ├── task-2.md
│ └── ...
├── .taskflow/
│ └── config.json # TaskFlow configuration
└── ...
`

Configuration

TaskFlow can be configured via environment variables or a .taskflow.json configuration file:

`json
{
"storage": {
"path": "./tasks",
"format": "json"
},
"notifications": {
"enabled": true,
"frequency": "realtime"
}
}
`

Development

`bash


Clone the repository

git clone https://github.com/nazk/taskflow-mcp.git

Install dependencies

cd taskflow-mcp
npm install

Build the project

npm run build

Start in development mode

npm run dev
``

Documentation

For complete documentation of all features, see MCP_FEATURES.md.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT © nazk