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

Create and activate conda environment:

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

Install dependencies:

pip install mcp requests pip install --upgrade typer

Initialize project with uv:

uv init taskflow-mcp cd taskflow-mcp

Add the modular code to your project structure (see files above)
Install MCP CLI support:

uv add "mcp[cli]"

Install the MCP server:

uv run mcp install main.py

Claude Desktop Integration

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
Add TaskFlow MCP configuration:

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

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