TaskFlow MCP Server 101 [Learning]

Model Context Protocol (MCP) server for task management, built with FastMCP. Integrate task management capabilities into Claude Desktop.

Components

Task Management Tools

• Create Tasks: Generate new tasks with detailed specifications
• Update Status: Track progress through pending, in-progress, completed, cancelled
• Task Details: Get comprehensive information about any task
• User Tasks: List all tasks for specific team members
• Overdue Tracking: Identify and manage overdue tasks
• Smart Search: Find tasks by title, description, or tags

Resources

• Task Resource: JSON representation of individual tasks
• User Task Lists: Complete task portfolios for team members
• Dashboard Summary: Real-time project statistics and metrics

Model Prompts

• Task Creation Assistant: Guided task creation with SMART criteria
• Daily Standup: Automated standup report generation
• Project Planning: Break down complex projects into manageable tasks

Architecture

taskflow-mcp/
├── server.py              # Shared MCP server instance
├── database.py           # In-memory data storage
├── main.py              # Application entry point
├── tools/
│   └── task_tools.py    # Task management tools
├── resources/
│   └── task_resources.py # Task data resources
└── prompts/
    └── task_prompts.py   # assistant prompts

Quick Start

Prerequisites

• Python 3.10+
• conda or pip (conda pref)
• Claude Desktop (for integration)

Installation

1. Create and activate conda environment:

conda create -n mcp-project python=3.10
conda activate mcp-project

2. Install dependencies:

pip install mcp requests
pip install --upgrade typer

3. Initialize project with uv:

uv init taskflow-mcp
cd taskflow-mcp

4. Add the modular code to your project structure (see files above)

5. Install MCP CLI support:

uv add "mcp[cli]"

6. Install the MCP server:

uv run mcp install main.py

Claude Desktop Integration

1. Open Claude Desktop config file:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add TaskFlow MCP configuration:

{
  "mcpServers": {
    "TaskFlow": {
      "command": "/path/to/your/project/.venv/Scripts/python.exe",
      "args": [
        "/path/to/your/project/main.py"
      ]
    }
  }
}

3. Restart Claude Desktop and you'll see TaskFlow tools available!

Usage [Examples]

Creating a Task

Create a high-priority task for "Implement user authentication" assigned to muthu.pal with due date 2025-07-15

Checking Team Status

Show me all tasks for ankitha.pal that are currently in progress

Daily Standup

Generate a daily standup report showing today's focus items and any blockers

Project Planning

Help me break down a "Mobile App Development" project into manageable tasks

Available Tools

Tool	Description
create_task	Create new tasks with full specifications
update_task_status	Update task status and track completion
get_task_details	Retrieve comprehensive task information
list_tasks_by_user	Filter tasks by assignee and status
get_overdue_tasks	Identify overdue items needing attention
search_tasks	Search across titles, descriptions, and tags