> ## Documentation Index
> Fetch the complete documentation index at: https://prismeai-docs-next.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# monday.com
> Manage monday.com boards, items, docs and users from Prisme.ai workflows and AI agents
The monday.com app wraps the [monday.com](https://monday.com) v2 GraphQL API behind a simple Prisme.ai interface. It can be used either as a Builder app (automations call monday.com instructions directly) or as a remote MCP server consumed by an Knowledges agent — covering boards, items, columns, groups, workspaces, updates, files, webhooks, docs, folders, tags and activity logs.
Boards, items, subitems, columns and groups with full CRUD
Updates, notifications, webhooks, tags, users and teams
Workspaces, folders, docs and doc blocks
## Prerequisites
* A **monday.com** account
* A **Personal API Token (v2)** generated in *monday.com Developer center > My access tokens*
* Base URL (default: `https://api.monday.com`)
***
## Installation
1. Go to **Apps** in your workspace
2. Search for **monday.com** and install it
3. Open the app instance configuration and fill in the required fields
## Configuration
| Field | Description |
| --------------------------- | -------------------------------------------------------------------------------------- |
| **monday.com API Base URL** | Base URL of the monday.com API (default `https://api.monday.com`) |
| **Personal API Token** | monday.com Personal API Token (v2), stored as a workspace secret |
| **MCP Endpoint** | Auto-populated on install — URL of the MCP endpoint for this instance |
| **MCP API Key** | Auto-populated on install — signed key used in the `mcp-api-key` header. Do not modify |
`MCP Endpoint` and `MCP API Key` are generated automatically by the `onInstall` flow and are only needed to expose this instance as an MCP server (see the next tab).
## Available Instructions
Each instruction resolves credentials from the workspace configuration. All IDs are strings (monday.com uses numeric IDs wrapped as strings). Most list operations accept `limit` and `page` for pagination, with 25 items per page by default.
### Boards
| Instruction | Arguments |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `boards` | `ids`, `workspace_ids`, `state` (`active`/`all`/`archived`/`deleted`), `order_by` (`created_at`/`used_at`), `board_kind` (`private`/`public`/`share`), `limit`, `page` |
| `get_board` | `id`\* |
| `create_board` | `board_name`*, `board_kind`* (`private`/`public`/`share`), `description`, `folder_id`, `workspace_id`, `template_id`, `board_owner_ids`, `board_owner_team_ids`, `board_subscriber_ids`, `board_subscriber_teams_ids`, `empty` |
| `update_board` | `board_id`*, `board_attribute`* (`name`/`description`/`communication`), `new_value`\* |
| `duplicate_board` | `board_id`*, `duplicate_type`* (`duplicate_board_with_pulses`/`duplicate_board_with_pulses_and_updates`/`duplicate_board_with_structure`), `board_name`, `workspace_id`, `folder_id`, `keep_subscribers` |
| `archive_board` | `board_id`\* |
| `delete_board` | `board_id`\* |
### Items & Subitems
| Instruction | Arguments |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `items_page` | `board_ids`\*, `query_params`, `cursor`, `limit` |
| `items_page_by_column_values` | `board_id`*, `columns`* (array of `{column_id, column_values}`), `cursor`, `limit` |
| `get_items` | `ids`\* (max 100), `newest_first`, `exclude_nonactive` |
| `create_item` | `board_id`*, `item_name`*, `group_id`, `column_values`, `create_labels_if_missing`, `position_relative_method` (`before_at`/`after_at`), `relative_to` |
| `create_subitem` | `parent_item_id`*, `item_name`*, `column_values`, `create_labels_if_missing` |
| `duplicate_item` | `board_id`\*, `item_id`, `with_updates` |
| `move_item_to_group` | `item_id`*, `group_id`* |
| `move_item_to_board` | `item_id`*, `board_id`*, `group_id`\*, `columns_mapping`, `subitems_columns_mapping` |
| `archive_item` | `item_id`\* |
| `delete_item` | `item_id`\* |
| `clear_item_updates` | `item_id`\* |
### Columns
| Instruction | Arguments |
| ------------------------------- | ------------------------------------------------------------------------------------------------- |
| `columns` | `board_id`\* |
| `create_column` | `board_id`*, `title`*, `column_type`\* (see enum below), `description`, `defaults`, `id` |
| `change_column_title` | `board_id`*, `column_id`*, `title`\* |
| `change_column_metadata` | `board_id`*, `column_id`*, `column_property`\* (`title`/`description`), `value`\* |
| `delete_column` | `board_id`*, `column_id`* |
| `change_column_value` | `board_id`*, `column_id`*, `value`\* (JSON), `item_id`, `create_labels_if_missing` |
| `change_simple_column_value` | `board_id`*, `column_id`*, `value`\* (string), `item_id`, `create_labels_if_missing` |
| `change_multiple_column_values` | `board_id`*, `column_values`* (map of `column_id → value`), `item_id`, `create_labels_if_missing` |
`column_type` accepts: `auto_number`, `board_relation`, `button`, `checkbox`, `color_picker`, `country`, `creation_log`, `date`, `dependency`, `dropdown`, `email`, `file`, `formula`, `hour`, `item_assignees`, `item_id`, `last_updated`, `link`, `location`, `long_text`, `mirror`, `name`, `numbers`, `people`, `phone`, `progress`, `rating`, `status`, `subtasks`, `tags`, `team`, `text`, `timeline`, `time_tracking`, `vote`, `week`, `world_clock`.
### Groups
| Instruction | Arguments |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `groups` | `board_ids`\* |
| `create_group` | `board_id`*, `group_name`*, `position`, `relative_to`, `position_relative_method` (`before_at`/`after_at`) |
| `update_group` | `board_id`*, `group_id`*, `group_attribute`\* (`title`/`color`/`position`/`relative_position_after`/`relative_position_before`), `new_value`\* |
| `duplicate_group` | `board_id`*, `group_id`*, `add_to_top`, `group_title` |
| `archive_group` | `board_id`*, `group_id`* |
| `delete_group` | `board_id`*, `group_id`* |
### Users & Teams
| Instruction | Arguments |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `users` | `ids`, `emails`, `name`, `kind` (`all`/`non_guests`/`guests`/`non_pending`), `newest_first`, `non_active`, `limit`, `page` |
| `me` | – |
| `invite_users` | `emails`\*, `user_role` (`member`/`viewer`/`guest`/`admin`), `product` (`core`/`crm`/`dev`/`service`/`form`/`projectManagement`/`workManagement`/`workforms`) |
| `deactivate_users` | `user_ids`\* |
| `teams` | `ids` |
| `add_users_to_team` | `team_id`*, `user_ids`* |
| `remove_users_from_team` | `team_id`*, `user_ids`* |
### Workspaces
| Instruction | Arguments |
| ----------------------------- | ----------------------------------------------------------------------------------------------- |
| `workspaces` | `ids`, `kind` (`open`/`closed`), `state` (`active`/`all`/`archived`/`deleted`), `limit`, `page` |
| `create_workspace` | `name`*, `kind`* (`open`/`closed`), `description` |
| `update_workspace` | `id`*, `attributes`* (`{name, kind, description}`) |
| `delete_workspace` | `workspace_id`\* |
| `add_users_to_workspace` | `workspace_id`*, `user_ids`*, `kind`\* (`subscriber`/`owner`) |
| `delete_users_from_workspace` | `workspace_id`*, `user_ids`* |
### Updates (comments)
| Instruction | Arguments |
| ------------------------------- | -------------------------------- |
| `updates` | `ids`, `limit`, `page` |
| `item_updates` | `item_id`\*, `limit`, `page` |
| `create_update` | `item_id`*, `body`*, `parent_id` |
| `edit_update` | `id`*, `body`* |
| `delete_update` | `id`\* |
| `pin_to_top` / `unpin_from_top` | `id`\* |
| `like_update` / `unlike_update` | `update_id`\* |
### Tags & Assets
| Instruction | Arguments |
| ------------------- | ------------------------ |
| `tags` | `ids` |
| `board_tags` | `board_id`\* |
| `create_or_get_tag` | `tag_name`\*, `board_id` |
| `assets` | `ids`\* |
### Webhooks & Notifications
| Instruction | Arguments |
| --------------------- | -------------------------------------------------------------------- |
| `webhooks` | `board_id`\*, `app_webhooks_only` |
| `create_webhook` | `board_id`*, `url`*, `event`\*, `config` |
| `delete_webhook` | `id`\* |
| `create_notification` | `user_id`*, `target_id`*, `text`*, `target_type`* (`Project`/`Post`) |
`event` accepts: `change_column_value`, `change_status_column_value`, `change_subitem_column_value`, `change_specific_column_value`, `change_name`, `create_item`, `item_archived`, `item_deleted`, `item_moved_to_any_group`, `item_moved_to_specific_group`, `item_restored`, `create_subitem`, `change_subitem_name`, `move_subitem`, `subitem_archived`, `subitem_deleted`, `create_column`, `create_update`, `edit_update`, `delete_update`, `create_subitem_update`.
### Docs
| Instruction | Arguments |
| ------------------ | ----------------------------------------------------------------------------- |
| `docs` | `ids`, `object_ids`, `workspace_ids`, `folder_ids`, `limit`, `page` |
| `doc_blocks` | `doc_id`\*, `limit`, `page` |
| `create_doc` | `location`\* (either `{workspace: {...}}` or `{board: {item_id, column_id}}`) |
| `create_doc_block` | `doc_id`*, `type`*, `content`\*, `after_block_id`, `parent_block_id` |
| `update_doc_block` | `block_id`*, `content`* |
| `delete_doc_block` | `block_id`\* |
`create_doc_block.type` accepts: `normal_text`, `large_title`, `medium_title`, `small_title`, `bulleted_list`, `numbered_list`, `check_list`, `quote`, `code`, `table`, `divider`, `image`, `video`, `page_break`, `layout`, `toggle`.
### Folders
| Instruction | Arguments |
| --------------- | ----------------------------------------------------- |
| `folders` | `ids`, `workspace_ids`, `limit`, `page` |
| `create_folder` | `workspace_id`*, `name`*, `color`, `parent_folder_id` |
| `update_folder` | `folder_id`\*, `name`, `color`, `parent_folder_id` |
| `delete_folder` | `folder_id`\* |
`create_folder.color` accepts the monday.com palette: `done_green`, `bright_green`, `working_orange`, `dark_orange`, `sunset`, `stuck_red`, `dark_red`, `sofia_pink`, `lipstick`, `purple`, `dark_purple`, `berry`, `dark_blue`, `indigo`, `navy`, `bright_blue`, `aquamarine`, `chili_blue`, `river`, `winter`, `explosive`, `american_gray`, `blackish`, `brown`.
### Meta & Admin
| Instruction | Arguments | Description |
| ------------------ | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| `activity_logs` | `board_ids`\*, `from`, `to`, `user_ids`, `column_ids`, `group_ids`, `item_ids`, `limit`, `page` | Activity log of one or more boards |
| `board_views` | `board_id`\* | Views configured on a board |
| `account` | – | Account meta (name, slug, tier, members, logo) |
| `account_products` | – | Products installed (CRM, Dev, Service, WM, …) |
| `complexity` | – | Remaining complexity budget of the API token (per-minute) |
| `version` | – | API version currently served |
Arguments flagged with `*` are required.
## DSUL Examples
### Create a Board With an Item
```yaml theme={null}
- Monday.create_board:
board_name: Q2 Roadmap
board_kind: private
workspace_id: '{{workspace_id}}'
output: board
- Monday.create_item:
board_id: '{{board.id}}'
item_name: Ship onboarding revamp
group_id: topics
column_values:
status:
label: Working on it
date:
date: 2026-05-15
create_labels_if_missing: true
output: item
```
### Update a Status Column
```yaml theme={null}
- Monday.change_simple_column_value:
board_id: '{{board_id}}'
item_id: '{{item_id}}'
column_id: status
value: Done
output: result
```
### Post an Update and Notify a User
```yaml theme={null}
- Monday.create_update:
item_id: '{{item_id}}'
body: Deployed to staging.
output: update
- Monday.create_notification:
user_id: '{{owner_id}}'
target_id: '{{item_id}}'
text: Staging is ready for review
target_type: Project
```
### Paginate Items of a Board
```yaml theme={null}
- Monday.items_page:
board_ids:
- '{{board_id}}'
limit: 100
output: firstPage
- Monday.items_page:
board_ids:
- '{{board_id}}'
cursor: '{{firstPage.cursor}}'
output: nextPage
```
The monday.com app ships with a built-in MCP server. Each app instance gets its own signed `mcp-api-key` that encodes the workspace ID and a credentials lookup URL — the monday.com Personal API Token is never passed through headers and is resolved server-side from the app configuration.
## Legacy MCP Install (Advanced > Tools)
Use this flow to plug the monday.com MCP into an Knowledges agent that does not yet support the native MCP picker.
Install and configure the app in the same workspace as your agent (see the *Usage as App* tab). Once configured, `mcpEndpoint` and `mcpApiKey` are auto-populated.
Open the app instance config and copy the values of **MCP Endpoint** and **MCP API Key**.
Navigate to **Advanced > Tools**.
Click **Add** and select the **MCP** tab.
Paste the **MCP Endpoint** URL copied from the app instance.
In the **Headers** field, add the signed API key:
```json theme={null}
{
"mcp-api-key": "your-mcp-api-key"
}
```
The agent can now list and call monday.com tools through the MCP endpoint.
The signed `mcp-api-key` encodes the workspace ID and the `getConfig` webhook URL. The MCP server validates the signature using the central app secret and transparently fetches the monday.com token and base URL from the installed app. Credentials are cached per tenant for 10 minutes.
## Runtime Credential Override
At tool-call time, the MCP server resolves credentials in this order:
1. Per-session credentials set via the `configureMondayCom` tool (takes precedence)
2. Workspace-level credentials from the installed app
## Output Formats
Every tool accepts an `outputFormat` parameter that controls the MCP response shape:
* **`verbose`** (default) — human-readable text for LLM consumption
* **`structured`** — machine-readable JSON in `structuredContent`
* **`both`** — both text and structured content
## Available Tools
### Configuration
| Tool | Description |
| -------------------- | --------------------------------------------------------------------------------- |
| `configureMondayCom` | Store a monday.com Personal API Token (and optional base URL) in the user session |
### Boards
| Tool | Description |
| -------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| `boards` | List boards (optional filters by ids / workspace / state) |
| `get_board` | Get a single board with its groups, columns and paged items |
| `create_board` / `update_board` / `duplicate_board` / `archive_board` / `delete_board` | Full board lifecycle |
### Items & Subitems
| Tool | Description |
| ----------------------------------------------------- | --------------------------------------------------------------------------- |
| `items_page` | Cursor-paginated items of one or more boards (with optional `query_params`) |
| `items_page_by_column_values` | Paginated items filtered by column values |
| `get_items` | Fetch up to 100 items by ID |
| `create_item` / `create_subitem` / `duplicate_item` | Create or clone items |
| `move_item_to_group` / `move_item_to_board` | Relocate items |
| `archive_item` / `delete_item` / `clear_item_updates` | Archive, delete, or clear updates |
### Columns
| Tool | Description |
| ------------------------------------------------------------------ | ----------------------------------------------- |
| `columns` | List columns (with types and JSON settings) |
| `create_column` | Create any of 37 column types (see app tab) |
| `change_column_title` / `change_column_metadata` / `delete_column` | Rename or delete columns |
| `change_column_value` | Update a single value with a typed JSON payload |
| `change_simple_column_value` | Update a value with a simple string |
| `change_multiple_column_values` | Bulk-update several columns in one call |
### Groups
| Tool | Description |
| -------------------------------------------------------------------------------------- | --------------------------------- |
| `groups` | List groups of one or more boards |
| `create_group` / `update_group` / `duplicate_group` / `archive_group` / `delete_group` | Group lifecycle |
### Users & Teams
| Tool | Description |
| ---------------------------------------------- | -------------------------------------- |
| `users` | List users (filter by kind/email/name) |
| `me` | Get the user whose token is used |
| `invite_users` / `deactivate_users` | Manage user lifecycle |
| `teams` | List teams |
| `add_users_to_team` / `remove_users_from_team` | Manage team membership |
### Workspaces
| Tool | Description |
| ------------------------------------------------------------ | ----------------------------- |
| `workspaces` | List workspaces |
| `create_workspace` / `update_workspace` / `delete_workspace` | Workspace lifecycle |
| `add_users_to_workspace` / `delete_users_from_workspace` | Manage subscribers and owners |
### Updates (comments)
| Tool | Description |
| ------------------------------------------------- | -------------------- |
| `updates` / `item_updates` | List updates |
| `create_update` / `edit_update` / `delete_update` | Manage updates |
| `pin_to_top` / `unpin_from_top` | Pin or unpin updates |
| `like_update` / `unlike_update` | React to updates |
### Tags, Assets, Webhooks, Notifications
| Tool | Description |
| ------------------------------------------------ | ------------------------------------- |
| `tags` / `board_tags` / `create_or_get_tag` | Browse and create tags |
| `assets` | Fetch file assets by ID |
| `webhooks` / `create_webhook` / `delete_webhook` | Manage board webhooks |
| `create_notification` | Send an in-app notification to a user |
### Docs & Folders
| Tool | Description |
| --------------------------------------------------------------- | ---------------------------------------------------- |
| `docs` / `doc_blocks` | List docs and blocks |
| `create_doc` | Create a doc in a workspace or attach it to a column |
| `create_doc_block` / `update_doc_block` / `delete_doc_block` | Manage doc blocks (17 block types) |
| `folders` / `create_folder` / `update_folder` / `delete_folder` | Manage folders in a workspace |
### Meta & Admin
| Tool | Description |
| ------------------------------ | ------------------------------------------------ |
| `activity_logs` | Activity log of boards, filtered by time or user |
| `board_views` | Views configured on a board |
| `account` / `account_products` | Account info and installed products |
| `complexity` | Remaining per-minute complexity budget |
| `version` | API version currently served |
## Tool Details
### configureMondayCom
Store a monday.com Personal API Token in the user session. Takes precedence over the installed app config for the current session.
```json theme={null}
{
"name": "configureMondayCom",
"arguments": {
"token": "your-monday-api-token",
"baseUrl": "https://api.monday.com"
}
}
```
| Parameter | Required | Description |
| --------- | -------- | --------------------------------------------------- |
| `token` | Yes | monday.com Personal API Token (v2) |
| `baseUrl` | No | API base URL (defaults to `https://api.monday.com`) |
### create\_item
```json theme={null}
{
"name": "create_item",
"arguments": {
"board_id": "1234567890",
"item_name": "Ship onboarding revamp",
"group_id": "topics",
"column_values": {
"status": { "label": "Working on it" },
"date": { "date": "2026-05-15" }
},
"create_labels_if_missing": true
}
}
```
`column_values` is a map of `column_id → value`, with the payload shape depending on the column type (see monday.com API reference). Set `create_labels_if_missing: true` to auto-create missing `status`/`dropdown` labels.
### items\_page\_by\_column\_values
Filter board items by column values server-side.
```json theme={null}
{
"name": "items_page_by_column_values",
"arguments": {
"board_id": "1234567890",
"columns": [
{ "column_id": "status", "column_values": ["Done"] },
{ "column_id": "person", "column_values": ["alice@example.com"] }
],
"limit": 50
}
}
```
### change\_column\_value vs change\_simple\_column\_value
* `change_column_value` takes a **typed JSON payload** (e.g. `{"label": "Done"}` for `status`, `{"date": "2026-05-15"}` for `date`).
* `change_simple_column_value` takes a **plain string** and lets monday.com infer the format (e.g. `Done`, `2026-05-15`).
Use the typed variant when you need precise control (e.g. writing a people column with `{"personsAndTeams":[{"id":123,"kind":"person"}]}`).
### create\_webhook
```json theme={null}
{
"name": "create_webhook",
"arguments": {
"board_id": "1234567890",
"url": "https://api.studio.prisme.ai/v2/workspaces/.../webhooks/monday",
"event": "change_column_value",
"config": { "columnId": "status" }
}
}
```
`config` is required for `change_specific_column_value` and `item_moved_to_specific_group`.
### create\_notification
```json theme={null}
{
"name": "create_notification",
"arguments": {
"user_id": "987",
"target_id": "1234567890",
"text": "Staging is ready for review",
"target_type": "Project"
}
}
```
`target_type` is `Project` for board items/boards, `Post` for updates.
### create\_doc
```json theme={null}
{
"name": "create_doc",
"arguments": {
"location": {
"workspace": {
"workspace_id": "42",
"name": "Release Notes",
"kind": "private",
"folder_id": "99"
}
}
}
}
```
To attach a doc to a board item, use `location.board` instead:
```json theme={null}
{ "location": { "board": { "item_id": "1234567890", "column_id": "doc_column" } } }
```
***
## Error Handling
| HTTP Status | Error | Solution |
| ----------- | ------------ | ------------------------------------------------------------------------------------------------- |
| 401 | Unauthorized | Regenerate the Personal API Token in *Developer center > My access tokens* |
| 403 | Forbidden | Check the board/workspace permissions of the token owner |
| 404 | Not Found | Verify board, item, group or column IDs |
| 429 | Rate Limited | monday.com enforces a per-minute complexity budget — call `complexity` to inspect it and back off |
### Common Issues
**"Complexity budget exceeded"** — monday.com rate limits by query complexity, not request count. Large `items_page` calls can exhaust the budget quickly. Paginate with smaller `limit`, or fetch fewer columns.
**"Invalid column value"** — The payload shape depends on the column type. Prefer `change_simple_column_value` for simple types (text, numbers, status) and `change_column_value` for complex ones (people, dropdown, timeline).
**"create\_labels\_if\_missing has no effect"** — It only applies to `status` and `dropdown` columns, and requires the integration to have board-level write access.
**"Invalid API key" (MCP)** — The `mcp-api-key` header does not match the central app secret. Reinstall the app instance to regenerate a signed key.
## External Resources
Official monday.com API reference
Per-column-type payload reference
Plug MCP servers into Knowledges agents
Webhook events and payloads