# Flow MCP

> Flow connects your AI agent directly to Flow project management, letting you manage complex workstreams and team tasks without logging into a dashboard. Use it to list top-level workspaces, retrieve specific projects, create new tasks, update due dates, or read task discussions from any MCP-compatible client.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-tracking, project-planning, team-collaboration, workflow-management, task-automation, workspace-organization

## Description

This MCP lets your AI agent handle the details of project coordination and team communication directly inside your chat window. You can stop jumping between tabs just to check a status update. Instead, you talk to your agent, and it interacts with Flow’s entire system. Need an overview of every workspace or just want to list all projects within one? It handles that. You can create new tasks for team members, change task statuses from incomplete to completed, and even read the full discussion history on a specific piece of work.

It works by letting your AI client talk directly to Flow's data endpoints—all managed through Vinkius’s catalog. This means whether you use Claude or Cursor, you get access to the same comprehensive project tools. You can list workspace members and teams, keeping everyone in the loop without manual effort.

## Tools

### add_task_comment
Posts a comment directly onto an existing task record for team visibility.

### create_task
Generates and assigns a brand new task to a specified user or project list.

### get_project
Fetches all the detailed information about a single, specific project.

### get_task
Retrieves comprehensive details for one individual task item.

### list_task_lists
Lists all the categorized groups of tasks (Lists) that belong to a project.

### list_workspace_members
Outputs a roster of all team members currently assigned to the workspace.

### list_projects
Returns a list of all active projects within the current top-level workspace.

### list_task_comments
Retrieves the entire discussion thread and history for a specific task.

### list_tasks
Provides an overview of all tasks, allowing filtering by status or project.

### list_workspace_teams
Lists the different functional teams that operate within the workspace structure.

### list_workspaces
Gets a high-level directory of all top-level workspaces you belong to.

### update_task
Modifies an existing task, such as changing its status or reassigning it.

## Prompt Examples

**Prompt:** 
```
List all my Flow projects in the 'Marketing' workspace.
```

**Response:** 
```
Fetching projects... I found 4 projects in your 'Marketing' workspace, including 'Q4 Campaign' and 'Brand Guidelines'. Would you like to see the task lists for any of these?
```

**Prompt:** 
```
Create a new task: 'Review final design mockup' in the 'Design' list.
```

**Response:** 
```
Task created! I've added 'Review final design mockup' to your 'Design' task list. The task ID is 'task_123'. Would you like to assign it to someone or set a due date?
```

**Prompt:** 
```
Add a comment to task 'task_123': 'Design looks great, proceed to coding'.
```

**Response:** 
```
Comment added! Your feedback has been successfully posted to task 'task_123'. The team will see your update in the task discussion timeline.
```

## Capabilities

### Get high-level organizational view
Retrieve a list of all top-level workspaces or specific team structures within your company.

### Manage project lifecycle
List existing projects and fetch detailed metadata, including ownership information and deadlines.

### Create and modify tasks
Generate new tasks for team members or update the status of an existing task across any connected workspace.

### Track team communication
Read and add comments to specific tasks, keeping project discussions centralized.

### Maintain work hierarchy
Access and list task groups (Lists) within projects to keep the flow of work organized.

## Use Cases

### The Q2 Audit Check
A PM needs to know which projects were assigned to the 'Finance' team and if they are past due. They ask their agent to list_workspace_teams, then request details on all projects belonging to that group via list_projects and get_project. The AI compiles a single report showing status and ownership.

### The Quick Task Update
A developer finishes a piece of code and needs the task marked complete, but they don't have time to click through the UI. They simply tell their agent to use update_task on 'task_XYZ', and the status changes immediately.

### Client Onboarding Setup
A marketing manager is setting up a new client. Instead of manually creating multiple tasks, they ask their agent to create_task for all necessary steps in the 'Onboarding' list and assign them to three different team members.

### Finding Lost Context
A stakeholder joins a project late and needs to know what was decided last week. They ask their agent to list_task_comments on the main task, and the AI pulls up the entire discussion thread so they don't have to read through emails.

## Benefits

- You can check task statuses instantly. Instead of navigating to a project dashboard just to see if something is complete, you ask your agent to list tasks or use the update_task tool for immediate status changes.
- Never lose track of team discussions again. The list_task_comments tool pulls in all historical feedback and comments for any task so you always know who said what and when.
- Project overviews are faster than ever. Use list_projects to see every active initiative, or use get_project to dive deep into a single project's full metadata without leaving your conversation.
- Team visibility is centralized. With list_workspace_members and list_workspace_teams, you can confirm who’s on the roster before assigning tasks, eliminating guesswork when coordinating large groups.
- Task creation is instant. Need to add something? Use create_task to generate a new assignment directly from your agent conversation, ready for review.

## How It Works

The bottom line is that it turns complex, multi-step UI navigation into a single conversation with your agent.

1. First, you subscribe to this MCP on Vinkius and provide your Flow Personal Access Token.
2. Next, you tell your AI client exactly what you need—like 'List all incomplete tasks for the Q4 Campaign project.'
3. Finally, your agent executes the command through Flow's API, giving you an instant update or confirmation of the action.

## Frequently Asked Questions

**How do I use Flow MCP to list all my active projects?**
You ask your agent to list_projects. It will return a comprehensive catalog of all current projects in the workspace, giving you an immediate overview and ownership details.

**Can Flow MCP update task statuses automatically?**
Yes, you can use the update_task tool. You just need to tell your agent which task ID needs changing (e.g., from 'In Progress' to 'Completed'), and it handles the modification.

**Does Flow MCP only work for assigned tasks?**
No, you can use list_tasks to see an overview of all tasks, even if they are not directly assigned to your name. This gives you a wider view of team capacity.

**What is the difference between get_task and list_tasks in Flow MCP?**
list_tasks provides an overview or directory of many tasks, while get_task pulls up every single detail for one specific task ID. Use list_tasks when you need a general view.

**How do I find out who is on the team using Flow MCP?**
Use the list_workspace_members tool. This gives you a direct roster of everyone associated with the workspace, which is great for assigning ownership.