@nazk/taskflow-mcp

TaskFlow MCP

A Model Context Protocol server that provides intelligent task management for Cursor IDE and other MCP clients.

Installation • Tools • Features • Configuration • Development

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

Quick Install

# 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

Starting the Server

# Start TaskFlow MCP server
npx taskflow-mcp

The server automatically registers with Cursor IDE when launched.

Client Compatibility

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

Task Management

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

AI Integration

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

Notifications

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

Creating Tasks

// 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"
  ]
});

Using AI Features

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:

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

Development

# 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