# Hive — how to use (mcp.ai)

Connect your Hive account and use 10 tools for project management straight from your AI agent. Connect with your own API key. Hive is a project management and team collaboration platform for managing actions, projects, workflows, resources, and workspace metadata.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hive?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hive_create_action`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hive`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hive/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hive/create/action` — Create a Hive action (task) in a workspace, optionally inside a project and assigned to users.
  - body: { title: string, project_id?: string, description?: string, assignee_ids?: string[], workspace_id: string }
- `POST https://api.mcp.ai/api/hive/create/label` — Create a color-coded label in a Hive workspace.
  - body: { name: string, color: string, workspace_id: string, parent_label_id?: string }
- `POST https://api.mcp.ai/api/hive/delete/action` — Soft-delete one Hive action by ID. Hive preserves soft-delete semantics; this tool does not permanently erase the action. Deleting an action that is already gone succeeds rather than failing.
  - body: { action_id: string }
- `POST https://api.mcp.ai/api/hive/delete/label` — Delete one label from a Hive workspace. Deleting a label that is already gone succeeds rather than failing.
  - body: { label_id: string, workspace_id: string }
- `POST https://api.mcp.ai/api/hive/get/action` — Get the current details of one Hive action by ID.
  - body: { action_id: string }
- `POST https://api.mcp.ai/api/hive/list/actions` — List Hive actions in a workspace, optionally narrowed by project, status, dates, hierarchy, or archive state.
  - body: { first?: integer, status?: string, deleted?: boolean, sort_by?: string, archived?: boolean, end_date?: string, project_id?: string, start_date?: string, next_cursor?: string, workspace_id: string, parent_action_id?: string, include_total_count?: boolean }
- `POST https://api.mcp.ai/api/hive/list/labels` — List labels configured in a Hive workspace and return label IDs usable in action search.
  - body: { first?: integer, sort_by?: string, next_cursor?: string, workspace_id: string }
- `POST https://api.mcp.ai/api/hive/list/projects` — List projects in a Hive workspace, with optional archive and parent-project filters.
  - body: { first?: integer, sort_by?: string, archived?: boolean, next_cursor?: string, workspace_id: string, parent_project_id?: string, include_total_count?: boolean }
- `POST https://api.mcp.ai/api/hive/list/workspaces` — List Hive workspaces accessible to the connected API key and return IDs needed by workspace-scoped tools.
  - body: { first?: integer, next_cursor?: string, include_total_count?: boolean }
- `POST https://api.mcp.ai/api/hive/search/actions` — Search action titles in a Hive workspace and return one offset-based result page.
  - body: { skip?: integer, limit?: integer, status?: string, sort_by?: string, archived?: boolean, end_date?: string, label_id?: string, project_id?: string, start_date?: string, assignee_id?: string, search_term: string, workspace_id: string }

## Example prompts
- "What can I do in Hive?"
- "Show me a summary of my Hive account"

## More
- Page: https://mcp.ai/hive
- Agent spec (llms.txt): https://mcp.ai/hive/llms.txt
- Postman collection: https://mcp.ai/hive/postman.json