# Hive (Project Management) MCP

> Hive MCP connects your AI client directly to your project management data. It lets you track initiatives, manage workspaces, and organize team tasks using natural conversation, without ever leaving your chat window. You can list projects, create new actions, check task assignments, and audit workflow templates—all hands-free.

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

## Description

Need to keep up with complex projects? This MCP gives your agent direct access to your entire Hive workspace. Instead of navigating through dozens of menus or copying data into a spreadsheet, you simply talk to it. You can ask for the status of an initiative across multiple teams, check who owns a specific task, or even discover what kind of standardized process should be used next time.

It's about bringing your project structure into conversation. Your agent handles everything from listing available workspaces and finding active projects to generating new tasks that fit existing team standards. If you’re looking for the best place to manage these kinds of connections, Vinkius hosts this MCP right alongside thousands of others, giving you one connection point for all your operational data.

This means when a project manager needs an update on a milestone, or a team lead needs to create three new tasks linked to specific goals, they just ask. Your agent uses the necessary tools to pull that live, structured information back to you in plain English.

## Tools

### list_workspaces
Gets a list of all workspaces you have access to in Hive.

### list_projects
Retrieves a comprehensive list of active projects within your selected workspace.

### list_actions
Shows you all the current operational tasks (actions) for a given project.

### create_action
Creates a brand new action or task within your chosen workspace.

### get_action
Retrieves all the detailed metadata and structural information for one specific action ID.

### list_labels
Discovers the visual categorization labels currently used across your workspace items.

### list_templates
Shows you all the repeatable workflow templates and action patterns available for use.

## Prompt Examples

**Prompt:** 
```
List all projects in my 'Marketing' workspace (ID: ws-marketing)
```

**Response:** 
```
I've found 4 active projects in the Marketing workspace: 'Q2 Social Campaign', 'Brand Refresh', 'Email Newsletter Automation', and 'Annual Event Planning'. Would you like the status of the social campaign?
```

**Prompt:** 
```
Create a new action called 'Finalize Budget' in workspace 'ws-finance'
```

**Response:** 
```
Action 'Finalize Budget' created successfully in your Finance workspace. It's currently unassigned and has no labels. Would you like me to assign it to Sarah or add a 'Priority' label?
```

**Prompt:** 
```
What are the action templates available in the 'Engineering' workspace?
```

**Response:** 
```
I've identified 3 action templates in Engineering: 'Bug Report', 'Feature Specification', and 'Code Review Checklist'. You can use these templates to ensure all required fields are filled when creating new actions.
```

## Capabilities

### View all workspaces and projects
You can get a list of every available workspace or project in your account environment.

### Manage tasks and assignments
You can create new operational tasks, view existing action lists, and retrieve specific details about any task ID.

### Analyze team structure and standards
You can discover available labels, taxonomy categories, or active workflow templates to ensure consistency across the organization.

## Use Cases

### I need an instant status report for a complex launch.
A PM asks their agent, 'What's the current status of the Q3 product launch across all departments?' The MCP executes `list_projects` and compiles a single narrative answer, detailing progress on multiple fronts without requiring manual dashboard checks.

### I need to create a high-priority bug fix task.
Instead of going into Hive's form editor, the agent handles it. The user prompts: 'Create an action for the UI bug and assign it to David.' The MCP uses `create_action` instantly, bypassing clicks.

### I need to know what processes we should be following.
An Ops Analyst asks the agent about best practices. The MCP runs `list_templates`, providing a list of available workflow patterns like 'Code Review Checklist' or 'Feature Specification,' ensuring proper adherence.

### I need to check who owns that old task from last month.
The user knows the action ID but not the details. They ask, 'What is the blocker for action XYZ?' The agent calls `get_action`, returning all metadata, including blockers and assigned owners.

## Benefits

- You never have to jump between tabs. Your agent pulls project data directly from Hive so you can track initiatives and list actions without leaving your chat client.
- Team leads gain immediate control over task creation. You simply ask the MCP to create an action, complete with assignments and links, right where you're chatting.
- Standardization becomes automatic. By listing available labels or templates, you ensure that every new project adheres to the correct organizational structure.
- Deep context retrieval means you get more than a status update. Using `get_action` gives you the exact structural metadata and details needed to find blockers instantly.
- You maintain visibility across environments. The MCP lets you list workspaces, so you know exactly where all your different projects are housed.
- Auditing is simpler. You can enumerate active workflow templates using `list_templates` to confirm team consistency quickly.

## How It Works

The bottom line is you treat project management like a conversation, letting your agent do the clicking for you.

1. Subscribe to this MCP on Vinkius.
2. Enter your Hive API Key credentials into your AI client settings.
3. Start talking to your agent and ask it to list projects or create a new action.

## Frequently Asked Questions

**How do I use the Hive MCP to see all my available project groups?**
You simply ask your agent, 'List all my active projects.' The MCP uses `list_projects` and gives you a clean list of every initiative running in your connected workspace.

**Can the Hive MCP create tasks for me from Slack?**
Yes. You can tell your agent, 'Create an action named X.' The MCP uses `create_action` to build and save that task directly into your designated workspace.

**What if I need detailed information on a specific task ID?**
You just provide the ID to your agent. It runs `get_action`, which returns all metadata, including who is assigned and what blockers exist for that item.

**Does the Hive MCP help me keep track of process standards?**
Absolutely. You can ask the agent to list templates or labels. The MCP uses `list_templates` and `list_labels`, helping you audit if your team is following consistent procedures.

**Can I check which workspaces my account has access to?**
Yes, ask the agent to list all available workspaces. The MCP calls `list_workspaces` and immediately provides a full directory of every tenant environment you can access.