# Monday — how to use (mcp.ai)

monday.com is a customizable work management platform for project planning, collaboration, and automation, supporting agile, sales, marketing, and more

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

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

### Endpoints
- `POST https://api.mcp.ai/api/monday/add/users/to/board` — Adds users to a monday.com board with a specified role.
  - body: { kind?: string, board_id: integer, user_ids: integer[] }
- `POST https://api.mcp.ai/api/monday/archive/board` — Archives a specified, existing, and unarchived board in monday.com; archived boards can typically be restored later.
  - body: { board_id: integer }
- `POST https://api.mcp.ai/api/monday/archive/item` — Archives an existing monday.com item, moving it from active board views to the archive where it can be potentially restored.
  - body: { item_id: integer }
- `POST https://api.mcp.ai/api/monday/change/simple/column/value` — Changes a specific column's value for a monday.com item using a simple string, suitable for text, status, or dropdown columns; can create new labels if `create labels if missing` is true for status/dr
  - body: { value: string, item_id: integer, board_id: integer, column_id: string, create_labels_if_missing?: boolean }
- `POST https://api.mcp.ai/api/monday/create/board` — Creates a monday.com board; `template id` if used must be accessible, and `folder id` must be in `workspace id` if both are provided.
  - body: { folder_id?: integer, board_kind: string, board_name: string, description?: string, template_id?: integer, workspace_id?: integer, board_owner_ids?: integer[], board_subscriber_ids?: integer[], board_subscriber_teams_ids?: integer[] }
- `POST https://api.mcp.ai/api/monday/create/column` — Creates a new column with a specified type and title on a monday.com board.
  - body: { title: string, board_id: integer, defaults?: string, column_type: string, description?: string, after_column_id?: string }
- `POST https://api.mcp.ai/api/monday/create/group` — Creates a new group with the given `group name` on an existing monday.com board, identified by its `board id`.
  - body: { board_id: integer, group_name: string }
- `POST https://api.mcp.ai/api/monday/create/item` — Creates a new item on a monday.com board, optionally assigning it to a group and setting column values.
  - body: { board_id: integer, group_id?: string, item_name: string, column_values?: string }
- `POST https://api.mcp.ai/api/monday/delete/column` — Deletes a specified column from a monday.com board; this action is destructive and cannot be undone via the api.
  - body: { board_id: integer, column_id: string }
- `POST https://api.mcp.ai/api/monday/delete/group` — Permanently deletes an existing group (and its items) from an existing board in monday.com.
  - body: { board_id: integer, group_id: string }
- `POST https://api.mcp.ai/api/monday/delete/item` — Permanently deletes an existing monday.com item; this action is irreversible via the api.
  - body: { item_id: integer }
- `POST https://api.mcp.ai/api/monday/duplicate/item` — Duplicates an item on a monday.com board, optionally including its updates.
  - body: { item_id: integer, board_id: integer, with_updates?: boolean }
- `POST https://api.mcp.ai/api/monday/get/group/details` — Retrieves details (id, title, color, archived/deleted status) for a specific group on an accessible monday.com board.
  - body: { board_id: integer, group_id: string }
- `POST https://api.mcp.ai/api/monday/list/board/items` — Retrieves id, name, and state for all items on a specified monday.com board.
  - body: { board_id: integer }
- `POST https://api.mcp.ai/api/monday/list/boards` — Retrieves a list of boards from a monday.com account, supporting pagination and filtering by state.
  - body: { page?: integer, limit?: integer, state?: string }
- `POST https://api.mcp.ai/api/monday/list/columns` — Lists all columns and their properties for a specified monday.com `board id`; the board must exist.
  - body: { board_id: integer }
- `POST https://api.mcp.ai/api/monday/list/items` — Retrieves specified subitems from monday.com using their ids, returning the raw json response.
  - body: { item_ids: integer[] }
- `POST https://api.mcp.ai/api/monday/list/users` — Retrieves a list of users from monday.com; an empty user list in the response 'data' field does not signify action failure.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/monday/move/item/to/board` — Moves a monday.com item to a specified board and group; requires the item, target board, and target group to exist.
  - body: { item_id: integer, board_id: integer, group_id: string }
- `POST https://api.mcp.ai/api/monday/move/item/to/group` — Moves an item to a different group on the same monday.com board; the item and group must exist.
  - body: { item_id: integer, group_id: string }
- `POST https://api.mcp.ai/api/monday/update/board` — Updates a specified attribute of an existing board on monday.com.
  - body: { board_id: integer, new_value: string, board_attribute: string }

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