# Breeze — how to use (mcp.ai)

Connect your Breeze account and use 18 tools for project management straight from your AI agent. Connect with your own API key. Breeze is a project management software that helps teams plan, track, and collaborate on projects efficiently.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_breeze?ms=1787295900000`
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. `breeze_add_project_people`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/breeze`
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/breeze/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/breeze/add/project/people` — Add people to a Breeze project by inviting them via email. This action invites one or more users to a project by their email addresses. The response returns the complete list of all users currently in
  - body: { invitees: string[], project_id: integer }
- `POST https://api.mcp.ai/api/breeze/archive/project` — Tool to archive a specific project. Use when you need to hide a completed or inactive project from active views after confirming its details.
  - body: { team_id?: integer, project_id: integer }
- `POST https://api.mcp.ai/api/breeze/create/card` — Tool to create a new card in a project. Use after confirming the project_id. Creates a task with details like name, due date, and assignees.
  - body: { name: string, tags?: string[], duedate?: string, invitees?: string[], stage_id?: integer, startdate?: string, project_id: integer, description?: string, swimlane_id?: integer, planned_time?: integer, custom_fields?: object[] }
- `POST https://api.mcp.ai/api/breeze/create/list` — Tool to create a new list (stage) in a Breeze project. Use when you've selected a project and need to add a new stage. Example: "Create a new Todo list for project 42."
  - body: { name: string, project_id: integer }
- `POST https://api.mcp.ai/api/breeze/create/project` — Creates a new project in Breeze project management system. Use this action to initialize a new project with a given name. The newly created project will: - Be automatically assigned to the authenticat
  - body: { name: string }
- `POST https://api.mcp.ai/api/breeze/create/workspace` — Tool to create a new workspace. Use after deciding on the workspace name.
  - body: { name: string }
- `POST https://api.mcp.ai/api/breeze/delete/card` — Tool to delete a specific card (task) by its ID. Use when you need to remove a task permanently; deletions cannot be undone.
  - body: { card_id: integer, project_id: integer }
- `POST https://api.mcp.ai/api/breeze/delete/project` — Tool to delete a specific project by ID. Use when you need to remove a project after confirming its ID.
  - body: { project_id: integer }
- `POST https://api.mcp.ai/api/breeze/delete/project/person` — Tool to delete a person from a project by user ID. Use after confirming the project and user details. Example: "Delete user 456 from project 123".
  - body: { user_id: integer, project_id: integer }
- `POST https://api.mcp.ai/api/breeze/delete/workspace` — Tool to delete a specific workspace by ID. Use when permanently removing a workspace after confirming the correct workspace ID.
  - body: { workspace_id: integer }
- `POST https://api.mcp.ai/api/breeze/get/card` — Tool to retrieve detailed info for a specific card (task) in a project. Use when you know the project_id and card_id and need all metadata like tags, users, todos, and time entries.
  - body: { card_id: integer, project_id: integer }
- `POST https://api.mcp.ai/api/breeze/get/cards` — Tool to get all cards (tasks) for a specific project. Use after confirming the project exists. Example: "List all cards in project 42."
  - body: { archived?: boolean, project_id: integer }
- `POST https://api.mcp.ai/api/breeze/get/project` — Tool to get a specific project by ID. Use when you need detailed project information after confirming the project ID. Example: "Get project 123 details".
  - body: { project_id: integer }
- `POST https://api.mcp.ai/api/breeze/get/project/people` — Tool to get all users in a project. Use when you have a valid project ID and need to list its users.
  - body: { project_id: integer }
- `POST https://api.mcp.ai/api/breeze/get/projects` — Retrieves a list of all active (non-archived) projects in Breeze. Returns comprehensive project details including budget, time tracking, assigned users, tags, and metadata. Use this action to: - Get a
  - body: { team_id?: integer }
- `POST https://api.mcp.ai/api/breeze/get/workspace` — Tool to get a specific workspace by ID. Use when you need workspace details including projects after confirming the workspace ID.
  - body: { workspace_id: integer }
- `POST https://api.mcp.ai/api/breeze/get/workspaces` — Tool to get all workspaces. Use when you need to list available workspaces for the authenticated user.
- `POST https://api.mcp.ai/api/breeze/move/card` — Tool to move a card to a different stage or position. Use after confirming stage_id and prev_id.
  - body: { card_id: integer, prev_id?: integer, stage_id: integer, project_id: integer }

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

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