> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corsair.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Monday MCP API reference

> API reference for the Monday MCP plugin in Corsair: every `mondaymcp.api.*` operation with its input and output types, taken from the plugin's Zod schemas.

> [!NOTE]
>
> **New to Corsair?** See [API access](https://docs.corsair.dev/concepts/api.md), [authentication](https://docs.corsair.dev/concepts/auth.md), and [error handling](https://docs.corsair.dev/concepts/error-handling).

## Agents

### catalog

`agents.catalog`

Browses the account-wide catalog of available trigger types and skills for monday platform agents using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.agents.catalog({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `action` | `list_triggers \| list_skills` | Yes | list\_triggers or list\_skills. |
| `block_reference_ids` | `any[]` | No | Used with list\_triggers. Fetch specific trigger types by block\_reference\_id. Omit to return all trigger types. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### manage

`agents.manage`

Full lifecycle management for monday platform agents — create, read, update, delete, change state, and run — using the Platform MCP.

**Risk:** `destructive`

```ts theme={null}
await corsair.mondaymcp.api.agents.manage({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `action` | `create \| create_blank \| get \| update \| delete \| activate \| deactivate \| run` | Yes | One of create, create\_blank, get, update, delete, activate, deactivate, run. |
| `agent_id` | `string` | No | Required for update, delete, activate, deactivate, run. Use with get to fetch a specific agent; omit it with get to list owned agents. |
| `prompt` | `string` | No | Required for create. Plain-language description of what the agent should do. |
| `agent_model` | `any` | No | Used with create or update. Omit unless the user explicitly names a valid monday-supported model. |
| `name` | `string` | No | Used with create\_blank or update. Display name of the agent. |
| `role` | `string` | No | Used with create\_blank or update. Short role title (e.g. "Customer Success Bot"). |
| `role_description` | `string` | No | Used with create\_blank or update. Detailed description of the agent role. |
| `avatar_url` | `string` | No | Used with create\_blank. HTTPS URL of the avatar. Prefer dapulse-res.cloudinary.com or cdn.monday.com. |
| `gender` | `male \| female` | No | Used with create\_blank. male or female — a hint for the generated avatar/name when profile fields are omitted. |
| `background_color` | `string` | No | Used with create\_blank. Lowercase hex, e.g. "#9450fd". |
| `user_prompt` | `string` | No | Used with create\_blank. Stored as metadata; not used for AI generation. |
| `plan` | `string` | No | Used with update. New step-by-step execution plan in markdown. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### manageKnowledge

`agents.manageKnowledge`

Lists, grants, updates, or revokes a monday platform agent's access to boards and docs using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.agents.manageKnowledge({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `action` | `list \| add \| update \| remove` | Yes | One of list, add, update, remove. |
| `agent_id` | `string` | Yes | Unique identifier of the agent. |
| `resource_id` | `string` | No | Required for add, update, remove. The ID of the board or doc to grant/update/revoke access to. |
| `scope_type` | `BOARD \| DOC` | No | Required for add, update, remove. The resource type: BOARD or DOC. |
| `permission_type` | `READ \| READ_WRITE` | No | Required for add and update. READ (agent can read) or READ\_WRITE (agent can read and write). |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### manageSkills

`agents.manageSkills`

Creates skills in the account catalog and attaches or detaches them from a monday platform agent using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.agents.manageSkills({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `action` | `create \| add \| remove` | Yes | One of create, add, remove. |
| `agent_id` | `string` | No | Required for add and remove. Not used for create (an account-level operation). |
| `name` | `string` | No | Required for create. Display name of the new skill. |
| `content` | `string` | No | Required for create. Markdown instructions defining what the skill does and how to execute it — this is the skill's runtime behavior. |
| `description` | `string` | No | Used with create. Short description shown in the catalog. |
| `skill_id` | `string` | No | Required for add and remove. The skill ID from agent\_catalog action: "list\_skills", or the ID returned by action: "create". Never guess a skill ID. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### manageTriggers

`agents.manageTriggers`

Lists, adds, or removes the triggers attached to a monday platform agent — triggers define when the agent runs automatically — using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.agents.manageTriggers({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `action` | `list \| add \| remove` | Yes | One of list, add, remove. |
| `agent_id` | `string` | Yes | Unique identifier of the agent. |
| `block_reference_id` | `string` | No | Required for add. The trigger type's block\_reference\_id from agent\_catalog action: "list\_triggers". Never guess this value. |
| `field_values` | `Record<string, any>` | No | Used with add when the trigger type has required fields. Key/value object whose shape is described by field\_schemas in the catalog. Scalar fields use string/number/boolean; selection fields use \{'\{ "value": "", "label": "" }'}. |
| `node_id` | `string` | No | Required for remove. The node\_id of the trigger instance — get it from action: "list". Each instance has a unique node\_id. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Assets

### finalizeUpload

`assets.finalizeUpload`

Completes a file upload started with get\_asset\_upload\_url, creates the asset, and attaches it to an item's file column using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.assets.finalizeUpload({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `uploadId` | `string` | Yes | The upload\_id returned by get\_asset\_upload\_url. |
| `etag` | `string` | Yes | The ETag header value from the PUT response when uploading to the presigned URL. |
| `boardId` | `string` | No | The board's unique identifier. Optional; the server resolves the board from the item. |
| `itemId` | `string` | Yes | The item's unique identifier. |
| `columnId` | `string` | Yes | The file or doc column's unique identifier to attach the uploaded asset to. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### get

`assets.get`

Retrieves file metadata for one or more monday.com assets by their IDs, including download URL, thumbnail, size, and uploader information using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.assets.get({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `ids` | `any[]` | Yes | Array of asset IDs to fetch. Must contain at least one ID. Asset IDs are numeric strings (e.g., `["12345678"]`). |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getUploadUrl

`assets.getUploadUrl`

Returns a presigned URL to upload a file to monday.com, the first step in attaching a file to an item using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.assets.getUploadUrl({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `fileName` | `string` | Yes | The name of the file to upload, including extension (e.g. "report.pdf"). |
| `contentType` | `string` | No | The MIME type of the file (e.g. "application/pdf", "image/png", "text/plain"). Optional when the extension is a known type. |
| `fileSize` | `number` | Yes | The file size in bytes. Maximum 500 MB (524288000 bytes). |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Automations

### create

`automations.create`

Creates an automation on a monday.com board from a structured natural-language description using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.automations.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `userPrompt` | `string` | Yes | Structured description of the automation to create, in the format the description of monday's `create_automation` MCP tool gives. |
| `boardId` | `string` | Yes | The numeric board ID as a string. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### list

`automations.list`

Lists all automations on a specific monday.com board, including their IDs, titles, active state, and configuration, using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.automations.list({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `string` | Yes | The numeric board ID as a string. |
| `limit` | `number` | No | Maximum number of automations to return (1–100). Default: 100. |
| `cursor` | `string` | No | Pagination cursor from a previous response. Pass it to retrieve the next page of automations. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### manage

`automations.manage`

Activates, deactivates, or deletes an existing monday.com automation using the Platform MCP.

**Risk:** `destructive`

```ts theme={null}
await corsair.mondaymcp.api.automations.manage({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `action` | `activate \| deactivate \| delete` | Yes | The operation to perform: activate (enable a paused automation), deactivate (pause without deleting), or delete (permanently remove — irreversible). |
| `workflowId` | `string` | Yes | The automation ID to operate on. Obtain it from list\_automations. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Boards

### create

`boards.create`

Creates a new monday.com board in a specified workspace with configurable visibility, description, and ownership using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.boards.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardName` | `string` | Yes | The display name of the new board. |
| `boardKind` | `string` | No | Visibility level of the board. One of `public`, `private`, or `share`. Defaults to `public`. |
| `boardDescription` | `string` | No | A short description of the board's purpose. |
| `workspaceId` | `string` | No | The ID of the workspace to create the board in. Use `list_workspaces` to discover workspace IDs. |
| `boardOwnerIds` | `any[]` | No | List of user IDs to set as board owners. Use `list_users_and_teams` to look up user IDs. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getActivity

`boards.getActivity`

Returns the activity log for a board, showing what changed, when, and by whom, over a configurable time range using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.boards.getActivity({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `number` | Yes | The ID of the board to retrieve activity logs for. |
| `fromDate` | `string` | No | Start of the activity window in ISO 8601 format (e.g. `2025-12-01T00:00:00Z`). Defaults to 30 days ago. |
| `toDate` | `string` | No | End of the activity window in ISO 8601 format. Defaults to the current time. |
| `includeData` | `boolean` | No | Whether to include the full before/after data payload for each event. Defaults to `false`. Can significantly increase response size. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getInfo

`boards.getInfo`

Returns comprehensive metadata for a board, including its columns, groups, views, owners, and workspace details using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.boards.getInfo({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `number` | Yes | The numeric ID of the board to retrieve information for. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getItemsPage

`boards.getItemsPage`

Retrieves items from a board with pagination, optional column values, filters, sorting, and sub-item support using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.boards.getItemsPage({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `number` | Yes | The ID of the board to retrieve items from. |
| `itemIds` | `any[]` | No | Fetch specific items by their IDs (maximum 100). |
| `searchTerm` | `string` | No | Free-text search term. Use when the user provides an approximate term rather than an exact column value. Prefer structured `filters` for exact matches. |
| `limit` | `number` | No | Number of items to return per page. Range: 1–500. Defaults to `25`. |
| `cursor` | `string` | No | Pagination cursor from the previous response's `nextCursor` field. |
| `includeColumns` | `boolean` | No | Whether to include column values. Defaults to `false`. Only enable when you need column data — it significantly increases response size. |
| `includeItemDescription` | `boolean` | No | Whether to include the item's rich-text description (body/notes). Defaults to `false`. |
| `includeSubItems` | `boolean` | No | Whether to include sub-items for each item. Defaults to `false`. |
| `subItemLimit` | `number` | No | Number of sub-items to return per item when `includeSubItems` is true. Range: 1–100. Defaults to `25`. |
| `filters` | `any[]` | No | Array of column filter objects. Each filter requires `columnId` and `compareValue`, with optional `operator` and `compareAttribute`. Call `get_column_type_info` with `fetchMode: "guidelines"` to understand valid filter values per column type. |
| `filtersOperator` | `string` | No | Logical operator for combining multiple filters. Either `and` (default) or `or`. |
| `columnIds` | `any[]` | No | Limit which columns are returned when `includeColumns` is true. Omit to return all columns. |
| `orderBy` | `any[]` | No | Array of sort objects with `columnId` and `direction` (`asc` or `desc`). |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### insights

`boards.insights`

Calculates aggregated summaries of board data by filtering, grouping, and applying aggregation functions to columns using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.boards.insights({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `number` | Yes | The ID of the board to calculate insights for. |
| `aggregations` | `any[]` | No | Array of aggregation objects, each with a `columnId` and an optional `function`. Supported functions include `COUNT`, `COUNT_ITEMS`, `SUM`, `AVERAGE`, `MIN`, `MAX`, `MEDIAN`, `LABEL`, `DATE_TRUNC_MONTH`, `DATE_TRUNC_WEEK`, and more. Columns in `groupBy` must also appear here without a function. |
| `groupBy` | `any[]` | No | Array of column IDs to group results by. All groupBy columns must also be present in `aggregations` without a function. |
| `limit` | `number` | No | Maximum number of result rows to return. Maximum 1000. Defaults to `1000`. |
| `filters` | `any[]` | No | Array of column filter objects (same structure as `get_board_items_page` filters). Narrows the item set before aggregation. |
| `filtersOperator` | `string` | No | Logical operator for combining multiple filters: `and` (default) or `or`. |
| `orderBy` | `any[]` | No | Array of sort objects with `columnId` and `direction` (`asc` or `desc`). |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Columns

### create

`columns.create`

Adds a new column of a specified type to a monday.com board, with an optional title, description, and type-specific settings using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.columns.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `number` | Yes | The ID of the board to add the column to. |
| `columnType` | `string` | Yes | The type of column to create. Supported types include: `auto_number`, `board_relation`, `checkbox`, `date`, `dependency`, `dropdown`, `email`, `file`, `formula`, `hour`, `link`, `location`, `long_text`, `numbers`, `people`, `phone`, `rating`, `status`, `tags`, `team`, `text`, `time_tracking`, `timeline`, `vote`, `week`, `world_clock`, and others. |
| `columnTitle` | `string` | Yes | The display title for the new column. |
| `columnDescription` | `string` | No | An optional description shown in the column header tooltip. |
| `columnSettings` | `string` | No | Column-specific configuration as a JSON string. Use `get_column_type_info` with `fetchMode: "schema"` to get the correct structure for a given type. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getTypeInfo

`columns.getTypeInfo`

Returns the JSON settings schema or filter/aggregation guidelines for a specific monday.com column type using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.columns.getTypeInfo({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `columnType` | `string` | Yes | The column type to look up (e.g. `status`, `text`, `date`, `numbers`, `people`, `dropdown`, `timeline`). |
| `fetchMode` | `string` | No | Either `schema` (default) to get the full JSON settings schema, or `guidelines` to get only filter and aggregation rules. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Dashboards

### allWidgetsSchema

`dashboards.allWidgetsSchema`

Returns the complete JSON Schema definitions for all available widget types in monday.com, including required fields, data types, and configuration options using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.dashboards.allWidgetsSchema({});
```

**Input:** *empty object*

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### create

`dashboards.create`

Creates a new monday.com dashboard that aggregates and visualizes data from one or more boards using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.dashboards.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `name` | `string` | Yes | Human-readable title for the dashboard (UTF-8 characters). |
| `workspace_id` | `string` | Yes | ID of the workspace that will own the dashboard. Use `list_workspaces` or `workspace_info` to find workspace IDs. |
| `board_ids` | `any[]` | Yes | List of board IDs (as strings) to connect to the dashboard. Minimum 1, maximum 50. All widgets on this dashboard will source data from these boards. |
| `kind` | `string` | No | Visibility level: `PUBLIC` or `PRIVATE`. Defaults to `PUBLIC`. |
| `board_folder_id` | `string` | No | Folder ID within the workspace to place the dashboard in. If omitted, the dashboard is placed in the workspace root. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### createWidget

`dashboards.createWidget`

Adds a new data visualization widget to a monday.com dashboard or board view with type-specific configuration settings using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.dashboards.createWidget({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `parent_container_id` | `string` | Yes | ID of the parent container — a dashboard ID or a board view ID. |
| `parent_container_type` | `string` | Yes | Type of the parent container. Must be `DASHBOARD` or `BOARD_VIEW`. |
| `widget_kind` | `string` | Yes | The type of widget to create. One of: `APP_FEATURE`, `BATTERY`, `CALENDAR`, `CHART`, `GANTT`, `LISTVIEW`, `NUMBER`. |
| `widget_name` | `string` | Yes | Display name for the widget (1–255 UTF-8 characters). |
| `settings` | `Record<string, any>` | No | Widget-specific configuration as a JSON object. Must conform to the schema for the specified `widget_kind`. Use `all_widgets_schema` to retrieve the required structure for each type. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Docs

### create

`docs.create`

Creates a new monday.com document in a workspace or attached to a board item, then populates it with the provided markdown content using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.docs.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `doc_name` | `string` | Yes | The display name of the new document. |
| `markdown` | `string` | Yes | Markdown content to import into the document as blocks on creation. |
| `location` | `string` | Yes | Where to create the document. One of `workspace` (standalone doc) or `item` (attached to a board item). |
| `workspace_id` | `number` | No | The ID of the workspace to create the document in. Use `list_workspaces` to discover workspace IDs. |
| `doc_kind` | `string` | No | Visibility of the document. One of `public`, `private`, or `share`. Defaults to `public`. Only used when location=`workspace`. |
| `folder_id` | `number` | No | ID of a folder to place the document inside. Only used when location=`workspace`. Use `search` with searchType `FOLDERS` to find folder IDs. |
| `item_id` | `number` | No | The ID of the board item to attach the document to. Only used when location=`item`. |
| `column_id` | `string` | No | ID of an existing doc column on the item's board. If omitted, a new doc column is created automatically. Only used when location=`item`. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### read

`docs.read`

Retrieves monday.com documents with their full markdown content and block structure, or fetches the version history of a single document using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.docs.read({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `mode` | `string` | No | Operation mode. `content` (default) retrieves documents with markdown content. `version_history` retrieves the edit history of a single document. |
| `type` | `string` | No | Query type for content mode. One of `ids` (doc IDs), `object_ids` (object IDs from the URL), or `workspace_ids`. Required when mode is `content`. |
| `ids` | `any[]` | Yes | Array of ID values matching the selected `type`. In `version_history` mode, provide the single document `object_id` here (e.g., `["18412502542"]`). |
| `limit` | `number` | No | Number of documents per page (default: 25). Content mode only. |
| `page` | `number` | No | Page number to return, starting at 1. Content mode only. |
| `order_by` | `string` | No | Sort order for results. One of `created_at` or `used_at`. Content mode only. |
| `include_blocks` | `boolean` | No | If `true`, includes block IDs, types, positions, and content in the response. Required before calling `update_doc`. Defaults to `false`. Content mode only. |
| `blocks_limit` | `number` | No | Maximum number of blocks to return per document (default: 25). Use with `blocks_page` to paginate long documents. Content mode only. |
| `blocks_page` | `number` | No | Page number for block pagination, starting at 1. Content mode only. |
| `include_comments` | `boolean` | No | If `true`, fetches all comments and replies on the document. Defaults to `false`. Content mode only. |
| `comments_limit` | `number` | No | Maximum number of comments to fetch per document when `include_comments` is `true`. Defaults to 50. Content mode only. |
| `version_history_limit` | `number` | No | Maximum number of restoring points to return. Version history mode only. |
| `since` | `string` | No | ISO 8601 date string to filter version history from (e.g., `"2026-03-15T00:00:00Z"`). Version history mode only. |
| `until` | `string` | No | ISO 8601 date string to filter version history until. Defaults to now. Version history mode only. |
| `include_diff` | `boolean` | No | If `true`, fetches content diffs between consecutive restoring points. May be slower. Version history mode only. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### update

`docs.update`

Updates an existing monday.com document by executing an ordered list of operations such as appending content, renaming, editing blocks, or adding comments using the Platform MCP.

**Risk:** `destructive`

```ts theme={null}
await corsair.mondaymcp.api.docs.update({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `doc_id` | `string` | No | The document ID returned by `read_docs` (`id` field). Takes priority over `object_id` if both are provided. |
| `object_id` | `string` | No | The document object ID visible in the document URL. Resolved to `doc_id` internally. |
| `operations` | `any[]` | Yes | Ordered list of operations to perform (1–25). Each operation requires an `operation_type` and type-specific fields; monday's `update_doc` MCP tool description lists the operation types. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Folders

### create

`folders.create`

Creates a new folder inside a monday.com workspace, with optional color, icon, font weight, and parent folder settings using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.folders.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `workspaceId` | `string` | Yes | The ID of the workspace where the folder will be created. |
| `name` | `string` | Yes | The name of the folder. |
| `color` | `string` | No | The folder's color. One of: `AQUAMARINE`, `BRIGHT_BLUE`, `BRIGHT_GREEN`, `CHILI_BLUE`, `DARK_ORANGE`, `DARK_PURPLE`, `DARK_RED`, `DONE_GREEN`, `INDIGO`, `LIPSTICK`, `NULL`, `PURPLE`, `SOFIA_PINK`, `STUCK_RED`, `SUNSET`, `WORKING_ORANGE`. |
| `fontWeight` | `string` | No | The font weight of the folder label. One of: `FONT_WEIGHT_BOLD`, `FONT_WEIGHT_LIGHT`, `FONT_WEIGHT_NORMAL`, `FONT_WEIGHT_VERY_LIGHT`, `NULL`. |
| `customIcon` | `string` | No | The icon displayed on the folder. One of: `FOLDER`, `MOREBELOW`, `MOREBELOWFILLED`, `NULL`, `WORK`. |
| `parentFolderId` | `string` | No | The ID of a parent folder to nest this folder inside. If omitted, the folder is created at the workspace root. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### moveObject

`folders.moveObject`

Moves a board, folder, or overview to a different position, parent folder, or workspace in monday.com using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.folders.moveObject({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `objectType` | `string` | Yes | The type of object to move. One of: `Board`, `Folder`, `Overview`. |
| `id` | `string` | Yes | The ID of the object to move. |
| `parentFolderId` | `string` | No | The ID of the destination folder. Provide this to move the object into a specific folder. |
| `workspaceId` | `string` | No | The ID of the destination workspace. Provide this when moving the object to a different workspace. |
| `accountProductId` | `string` | No | The ID of the destination account product. Provide this when moving to a different account product context. |
| `position_object_id` | `string` | No | The ID of a reference object to position this object relative to. Must be paired with `position_object_type`. |
| `position_object_type` | `string` | No | The type of the reference object for positioning. One of: `Board`, `Folder`, `Overview`. Must be paired with `position_object_id`. |
| `position_is_after` | `boolean` | No | If `true`, places this object after the reference object. If `false`, places it before. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### update

`folders.update`

Updates the name, color, icon, position, or parent of an existing folder in monday.com using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.folders.update({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `folderId` | `string` | Yes | The ID of the folder to update. |
| `name` | `string` | No | The new name for the folder. |
| `color` | `string` | No | The new color for the folder. One of: `AQUAMARINE`, `BRIGHT_BLUE`, `BRIGHT_GREEN`, `CHILI_BLUE`, `DARK_ORANGE`, `DARK_PURPLE`, `DARK_RED`, `DONE_GREEN`, `INDIGO`, `LIPSTICK`, `NULL`, `PURPLE`, `SOFIA_PINK`, `STUCK_RED`, `SUNSET`, `WORKING_ORANGE`. |
| `fontWeight` | `string` | No | The new font weight for the folder label. One of: `FONT_WEIGHT_BOLD`, `FONT_WEIGHT_LIGHT`, `FONT_WEIGHT_NORMAL`, `FONT_WEIGHT_VERY_LIGHT`, `NULL`. |
| `customIcon` | `string` | No | The new icon for the folder. One of: `FOLDER`, `MOREBELOW`, `MOREBELOWFILLED`, `NULL`, `WORK`. |
| `parentFolderId` | `string` | No | The ID of the new parent folder to nest this folder inside. |
| `workspaceId` | `string` | No | The ID of the workspace containing the folder. Required when moving the folder to a different workspace. |
| `accountProductId` | `string` | No | The account product ID to associate with the folder. |
| `position_object_id` | `string` | No | The ID of an object to position this folder relative to. Must be paired with `position_object_type`. |
| `position_object_type` | `string` | No | The type of object used as the positioning reference. One of: `Board`, `Folder`, `Overview`. Must be paired with `position_object_id`. |
| `position_is_after` | `boolean` | No | If `true`, positions the folder after the reference object. If `false`, positions it before. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Forms

### create

`forms.create`

Creates a new monday.com WorkForm and a backing board to store responses, returning a form token for subsequent form operations using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.forms.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `destination_workspace_id` | `string` | Yes | ID of the workspace in which the form and its backing board will be created. |
| `destination_name` | `string` | No | Name of the backing board that stores form responses. If omitted, the board receives a default name. |
| `board_kind` | `string` | No | Visibility of the backing board. One of `private`, `public`, or `share`. |
| `destination_folder_id` | `string` | No | ID of an existing folder to place the backing board in. |
| `destination_folder_name` | `string` | No | Name of a new folder to create and place the backing board in. |
| `board_owner_ids` | `any[]` | No | List of user IDs to set as owners of the backing board. |
| `board_owner_team_ids` | `any[]` | No | List of team IDs to set as owners of the backing board. |
| `board_subscriber_ids` | `any[]` | No | User IDs to notify on board activity. |
| `board_subscriber_teams_ids` | `any[]` | No | Team IDs to notify on board activity. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### createSubmission

`forms.createSubmission`

Submits a completed response to a monday.com WorkForm, creating a new item on the form's backing board with the provided answers using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.forms.createSubmission({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `form_token` | `string` | Yes | The form token, a full WorkForm URL, or a shortened wkf.ms URL. Shortened URLs are automatically resolved. |
| `answers` | `any[]` | Yes | Array of answer objects. Each object must include question\_id and exactly one answer field matching the question type; monday's `create_form_submission` MCP tool description lists the answer fields per type. |
| `form_timezone_offset` | `number` | Yes | The submitter's timezone offset in minutes (e.g., -120 for UTC−2, 0 for UTC, 120 for UTC+2). |
| `password` | `string` | No | Required only if the form has password protection enabled (check features.password.enabled from get\_form). |
| `tags` | `any[]` | No | Routing tags to attach to the submission. Each tag maps a column\_id to a value. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### editQuestions

`forms.editQuestions`

Creates, updates, or deletes a single question on a monday.com WorkForm, with support for 23 question types and conditional visibility rules using the Platform MCP.

**Risk:** `destructive`

```ts theme={null}
await corsair.mondaymcp.api.forms.editQuestions({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `action` | `string` | Yes | The operation to perform: create, update, or delete. |
| `formToken` | `string` | Yes | The unique token identifying the form. |
| `questionId` | `string` | No | ID of the question to update or delete. Required for update and delete. |
| `question` | `Record<string, any>` | No | The question definition. Required for create. For update, required with type always included. monday's `form_questions_editor` MCP tool description lists its sub-fields. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### get

`forms.get`

Retrieves the full structure of a monday.com WorkForm by its form token, including all questions, settings, appearance, and features using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.forms.get({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `formToken` | `string` | Yes | The unique token identifying the form. Extract from the form URL: the alphanumeric string after /forms/ and before ?. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### update

`forms.update`

Updates a monday.com WorkForm's settings, appearance, features, tags, or question order using a single action-based call using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.forms.update({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `formToken` | `string` | Yes | The unique token identifying the form. |
| `action` | `string` | Yes | The operation to perform; monday's `update_form` MCP tool description lists the supported actions and their required fields. |
| `form` | `Record<string, any>` | No | Form data to update. Required for updateFormHeader, updateAppearance, updateAccessibility, updateFeatures, and updateQuestionOrder. Patch semantics — only include the fields you want to change. |
| `formPassword` | `string` | No | Required for the setFormPassword action. |
| `tag` | `Record<string, any>` | No | Required for createTag, updateTag, and deleteTag. For create: provide name and value. For update: provide id and new value. For delete: provide id only. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Groups

### create

`groups.create`

Creates a new group (section) in a monday.com board with an optional color and position relative to existing groups using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.groups.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `string` | Yes | The ID of the board to create the group in. |
| `groupName` | `string` | Yes | The display name of the new group. Maximum 255 characters. |
| `groupColor` | `string` | No | Hex color for the group header. Must be one of the 19 predefined monday.com group colors: `#037f4c`, `#00c875`, `#9cd326`, `#cab641`, `#ffcb00`, `#784bd1`, `#9d50dd`, `#007eb5`, `#579bfc`, `#66ccff`, `#bb3354`, `#df2f4a`, `#ff007f`, `#ff5ac4`, `#ff642e`, `#fdab3d`, `#7f5347`, `#c4c4c4`, `#757575`. |
| `relativeTo` | `string` | No | The ID of an existing group to position this group relative to. Use `get_board_info` to find group IDs. |
| `positionRelativeMethod` | `string` | No | Whether to place the new group `before_at` or `after_at` the `relativeTo` group. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Items

### changeColumnValues

`items.changeColumnValues`

Updates one or more column values on an existing monday.com item in a single call using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.items.changeColumnValues({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `number` | Yes | The ID of the board that contains the item. |
| `itemId` | `number` | Yes | The ID of the item to update. |
| `columnValues` | `string` | Yes | A JSON string of column values to update. Keys are column IDs, values are type-specific. Examples: `{"text_col": "New value"}`, `{"status_col": {"label": "Done"}}`, `{"date_col": {"date": "2024-06-01"}}`, `{"email_col": "user@example.com"}`, `{"phone_col": "+1-800-555-0100"}`. |
| `createLabelsIfMissing` | `boolean` | No | If `true`, creates new Status or Dropdown labels that don't already exist. Requires board structure modification permission. Defaults to `false`. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### create

`items.create`

Creates a new item on a board, optionally with column values, as a sub-item under a parent, or as a duplicate of an existing item using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.items.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `number` | Yes | The ID of the board to create the item on. |
| `name` | `string` | Yes | The display name of the new item. |
| `columnValues` | `string` | Yes | A JSON string of initial column values. Keys are column IDs, values are type-specific. Examples: `{"text_col": "hello"}`, `{"status_col": {"label": "Done"}}`, `{"date_col": {"date": "2024-05-10"}}`, `{"email_col": "user@example.com"}`. |
| `groupId` | `string` | No | The ID of the group to add the item to. Defaults to the board's top group if not specified. |
| `parentItemId` | `number` | No | The ID of a parent item to create this as a sub-item under. |
| `duplicateFromItemId` | `number` | No | The ID of an existing item to duplicate as the base. Only provide when duplicating an item. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Meetings

### getNotetaker

`meetings.getNotetaker`

Retrieves monday.com AI Notetaker meetings by ID, or lists recent ones, with optional summaries, topics, action items and transcripts using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.meetings.getNotetaker({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `ids` | `string[]` | No | Meeting IDs to fetch in one call. Omit to list recent meetings for the chosen access level. |
| `access` | `OWN \| SHARED_WITH_ME \| SHARED_WITH_ACCOUNT \| ALL` | No | Which meetings to include. Defaults to ALL when ids are given; without ids, meetings shared only account-wide are left out unless ALL is passed. |
| `search` | `string` | No | Case-insensitive substring match on title, attendee name or email. Not a topic search. |
| `include_summary` | `boolean` | No | Include the AI-generated summary for each meeting. The summary is returned when no include\_ flag is set. |
| `include_topics` | `boolean` | No | Include discussion topics for each meeting. |
| `include_action_items` | `boolean` | No | Include action items for each meeting. |
| `include_transcript` | `boolean` | No | Include the full transcript for each meeting. Transcripts can be very large. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Notifications

### create

`notifications.create`

Sends a notification to a user via the monday.com bell icon, with an optional email, targeting an update/reply or an item/board using the Platform MCP.

**Risk:** `destructive`

```ts theme={null}
await corsair.mondaymcp.api.notifications.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `user_id` | `string` | Yes | The ID of the user to send the notification to. |
| `target_id` | `string` | Yes | The ID of the target object. Provide an update or reply ID when `target_type` is `"Post"`, or an item or board ID when `target_type` is `"Project"`. |
| `text` | `string` | Yes | The notification message text. |
| `target_type` | `string` | Yes | The context for the notification link. `"Post"` links to an update or reply; `"Project"` links to an item or board. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Schema

### executeQuery

`schema.executeQuery`

Executes any monday.com GraphQL query or mutation dynamically. The most flexible tool in the Platform MCP, giving direct access to the full monday.com API surface.

**Risk:** `destructive`

```ts theme={null}
await corsair.mondaymcp.api.schema.executeQuery({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `query` | `string` | Yes | The full GraphQL query or mutation string to execute. |
| `variables` | `string` | No | A JSON string containing the variables for the GraphQL operation. Defaults to "\{}". |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getGraphqlSchema

`schema.getGraphqlSchema`

Fetches the monday.com GraphQL schema structure, including all available query fields, mutation fields, and a list of every type in the schema using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.schema.getGraphqlSchema({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `operationType` | `string` | No | Filter results by operation type. Use "read" to return only query fields, or "write" to return only mutation fields. Omit to return both. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getTypeDetails

`schema.getTypeDetails`

Returns the full field list and type information for a specific GraphQL type in the monday.com API schema using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.schema.getTypeDetails({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `typeName` | `string` | Yes | The exact name of the GraphQL type to inspect. Type names are case-sensitive (e.g., "Board", "Item", "Column"). |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Search

### query

`search.query`

Searches across monday.com for boards, documents, or folders by keyword, with optional filtering by workspace using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.search.query({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `searchType` | `string` | Yes | The type of objects to search. One of `BOARD`, `DOCUMENTS`, or `FOLDERS`. |
| `searchTerm` | `string` | No | The keyword to search for. Omit or pass an empty string to return all objects of the given type. |
| `limit` | `number` | No | Number of results to return per page. Maximum and default is `20`. |
| `workspaceIds` | `any[]` | No | Array of workspace IDs to scope the search. Only pass this when you want to restrict results to specific workspaces. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Sprints

### getBoards

`sprints.getBoards`

Discovers monday Dev sprint boards and their paired tasks boards in your account using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.sprints.getBoards({});
```

**Input:** *empty object*

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getMetadata

`sprints.getMetadata`

Returns a table of sprints from a monday Dev sprints board, including timeline, status, and completion data for each sprint using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.sprints.getMetadata({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `sprintsBoardId` | `number` | Yes | The ID of the monday Dev board containing the sprints. Use `get_monday_dev_sprints_boards` to find this ID. |
| `limit` | `number` | No | Number of sprints to retrieve. Between 1 and 100. Defaults to 25. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getSummary

`sprints.getSummary`

Returns a complete AI-generated performance summary and analysis for a completed monday Dev sprint using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.sprints.getSummary({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `sprintId` | `number` | Yes | The ID of the sprint to get the summary for. Must be a completed sprint created after January 1, 2025. Use `get_sprints_metadata` to find sprint IDs. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Updates

### create

`updates.create`

Posts a new update (comment) on a monday.com item, with support for mentions and threaded replies using the Platform MCP.

**Risk:** `destructive`

```ts theme={null}
await corsair.mondaymcp.api.updates.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `itemId` | `number` | Yes | The ID of the item to post the update on. |
| `body` | `string` | Yes | The update text. Use HTML tags for formatting. Do not use `@` mentions here — use `mentionsList` instead. |
| `mentionsList` | `string` | No | JSON array of mention objects. Each object requires an `id` and a `type`. Valid types: `User`, `Team`, `Board`, `Project`. Example: `[{"id": "48202303", "type": "User"}]`. |
| `parentId` | `number` | No | The ID of an existing update to reply to. Omit this parameter to create a top-level update. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### list

`updates.list`

Retrieves updates (comments and posts) from a monday.com item or board, with optional filtering by date range, replies, and file attachments using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.updates.list({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `objectId` | `string` | Yes | The ID of the item or board to retrieve updates from. |
| `objectType` | `string` | Yes | The type of object: `"Item"` or `"Board"`. |
| `limit` | `number` | No | Number of updates to return per page. Default: `25`. Maximum: `100`. |
| `page` | `number` | No | Page number for pagination. Default: `1`. |
| `includeReplies` | `boolean` | No | Set to `true` to include threaded replies on each update. Default: `false`. |
| `includeAssets` | `boolean` | No | Set to `true` to include file attachments in the response. Default: `false`. |
| `fromDate` | `string` | No | Start of date range filter in ISO 8601 format (e.g. `"2025-01-01"` or `"2025-01-01T00:00:00Z"`). **Board queries only.** Must be used together with `toDate`. |
| `toDate` | `string` | No | End of date range filter in ISO 8601 format. **Board queries only.** Must be used together with `fromDate`. |
| `includeItemUpdates` | `boolean` | No | When `objectType` is `"Board"`, set to `true` to include updates on individual items. Default: `false` (board-level discussion only). |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Users

### getContext

`users.getContext`

Returns information about the currently authenticated user, their account, and their most relevant boards, people, and workspaces using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.users.getContext({});
```

**Input:** *empty object*

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### listAndTeams

`users.listAndTeams`

Fetches user profiles and team data from the account, with several targeting modes for looking up specific users or teams efficiently using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.users.listAndTeams({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `getMe` | `boolean` | No | Returns the current user's profile including team memberships. **Top priority** — use whenever the request refers to "me" or "my teams". Conflicts with all other parameters. |
| `userIds` | `any[]` | No | Array of specific user IDs to fetch (max 500). Always use when user IDs are available in context. Returns user profiles including team memberships. |
| `name` | `string` | No | Fuzzy name search for **users only**. Standalone — cannot be combined with other parameters. Do not use to search for teams. |
| `teamIds` | `any[]` | No | Array of specific team IDs to fetch (max 500). Always use when team IDs are known. Returns team details with owners and optional member data. |
| `includeTeams` | `boolean` | No | Fetches all teams in the account alongside users. **Avoid** — only use as a last resort. To get a specific user's teams, fetch that user by `userIds` instead. |
| `teamsOnly` | `boolean` | No | Returns only teams, no users. Combine with `teamIds` for targeted team lookup, or with `includeTeamMembers` for full member details. |
| `includeTeamMembers` | `boolean` | No | Set to `true` only when you need full member details for teams beyond names and IDs. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Views

### create

`views.create`

Creates a new board view (tab) with optional filters and sorting on a monday.com board using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.views.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `string` | Yes | The board ID to create the view on. |
| `type` | `any` | No | The type of board view to create. Defaults to TABLE. Use TABLE for standard board views. |
| `name` | `string` | No | The name of the view (e.g. "High Priority Items", "My Tasks"). |
| `filter` | `Record<string, any>` | No | Filter configuration. Contains rules (an array of \{ column\_id, compare\_value, operator }) and an optional operator (logical operator between rules, defaults to and). |
| `sort` | `any[]` | No | Sort configuration. Array of \{ column\_id, direction } objects. direction defaults to asc. |
| `settings` | `Record<string, any>` | No | Type-specific view settings as a JSON object. The shape varies by view type. For TABLE views, prefer create\_view\_table. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### createTable

`views.createTable`

Creates a new table-type board view with filters, sort, tags, and table-specific settings (column visibility/order and group-by) using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.views.createTable({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `boardId` | `string` | Yes | The board ID to create the table view on. |
| `name` | `string` | No | The name of the view (e.g. "High Priority Items", "My Tasks"). |
| `filter` | `Record<string, any>` | No | Filter configuration. Contains rules (an array of \{ column\_id, compare\_value, operator }) and an optional operator (logical operator between rules, defaults to and). |
| `sort` | `any[]` | No | Sort configuration. Array of \{ column\_id, direction } objects. direction defaults to asc. |
| `tags` | `any[]` | No | Tags to apply to the view. |
| `settings` | `Record<string, any>` | No | Table-specific settings: columns (visibility/order) and group\_by, as described in monday's `create_view_table` MCP tool. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### update

`views.update`

Updates an existing board view (tab) — its name, filters, or sort order — on a monday.com board using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.views.update({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `viewId` | `string` | Yes | The ID of the view to update. |
| `boardId` | `string` | Yes | The board ID the view belongs to. |
| `type` | `any` | No | The type of the board view being updated. Defaults to TABLE. |
| `name` | `string` | No | New name for the view (omit to leave unchanged). |
| `filter` | `Record<string, any>` | No | Filter configuration. Contains rules (an array of \{ column\_id, compare\_value, operator }) and an optional operator (logical operator between rules, defaults to and). |
| `sort` | `any[]` | No | Sort configuration. Array of \{ column\_id, direction } objects. direction defaults to asc. |
| `settings` | `Record<string, any>` | No | Type-specific view settings as a JSON object. The shape varies by view type. For TABLE views, prefer update\_view\_table. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### updateTable

`views.updateTable`

Updates an existing table-type board view — name, filters, sort, tags, or table-specific settings (column visibility/order and group-by) using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.views.updateTable({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `viewId` | `string` | Yes | The ID of the table view to update. |
| `boardId` | `string` | Yes | The board ID the view belongs to. |
| `name` | `string` | No | New name for the view (omit to leave unchanged). |
| `filter` | `Record<string, any>` | No | Filter configuration. Contains rules (an array of \{ column\_id, compare\_value, operator }) and an optional operator (logical operator between rules, defaults to and). |
| `sort` | `any[]` | No | Sort configuration. Array of \{ column\_id, direction } objects. direction defaults to asc. |
| `tags` | `any[]` | No | Tags to apply to the view. |
| `settings` | `Record<string, any>` | No | Table-specific settings: columns (visibility/order) and group\_by. Same shape as create\_view\_table. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Workflows

### create

`workflows.create`

Creates a new empty workflow in a monday.com workspace using the Platform MCP, returning the workflow object ID and draft ID.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.workflows.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `workspaceId` | `string` | Yes | The ID of the workspace to create the workflow in. |
| `title` | `string` | No | Workflow title. Defaults to "New Workflow". |
| `privacyKind` | `PUBLIC \| PRIVATE` | No | Visibility: PUBLIC (default) or PRIVATE. |
| `description` | `string` | No | Optional workflow description. |
| `folderId` | `string` | No | Optional folder ID to place the workflow in. |
| `ownerIds` | `any[]` | No | Optional list of user IDs to set as workflow owners. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### plan

`workflows.plan`

Plans one or more monday.com workflows for a described process using an AI agent, returning a structured implementation plan, via the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.workflows.plan({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `prompt` | `string` | Yes | Natural-language description of the full end-to-end process to plan (e.g. "When a deal is marked Won, create a task in the onboarding board and notify the account manager"). Maximum 2000 characters. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### update

`workflows.update`

Asks the monday.com workflow expert about a workflow, or has it add, edit or delete steps from a natural-language prompt (on a draft, or on the live version when no draft ID is given), via the Platform MCP.

**Risk:** `destructive`

```ts theme={null}
await corsair.mondaymcp.api.workflows.update({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `workflowObjectId` | `number` | Yes | The workflow object ID returned by create\_workflow (also in the workflow URL). Not an automation id. |
| `workflowDraftId` | `number` | No | The draft to work on, from the latest create\_workflow or workflows.update response. Omit to work on the live version. |
| `prompt` | `string` | Yes | A question about the workflow or the changes to make (e.g. "Add a trigger that fires when an item is created on the Marketing board"). |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

## Workspaces

### create

`workspaces.create`

Creates a new workspace in your monday.com account with a specified name, kind, and optional description using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.workspaces.create({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `name` | `string` | Yes | The name of the new workspace. |
| `workspaceKind` | `string` | Yes | The type of workspace to create. One of: `open`, `closed`, or `template`. Open workspaces are visible to all account members; closed workspaces require an explicit invite. |
| `description` | `string` | No | A short description of the workspace's purpose. |
| `accountProductId` | `string` | No | The account product ID to associate with the workspace (e.g., to scope the workspace to a specific monday product like CRM or Dev). |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### getInfo

`workspaces.getInfo`

Returns the boards, docs, and folders inside a workspace, including which folder each item belongs to using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.workspaces.getInfo({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `workspace_id` | `number` | Yes | The ID of the workspace to retrieve information for. Use list\_workspaces to find workspace IDs. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### list

`workspaces.list`

Returns a paginated list of all workspaces available to the authenticated user, including their IDs, names, and descriptions using the Platform MCP.

**Risk:** `read`

```ts theme={null}
await corsair.mondaymcp.api.workspaces.list({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `limit` | `number` | No | Number of workspaces to return per page. Min: `1`, max: `100`, default: `100`. Use a lower value for smaller responses. |
| `page` | `number` | No | Page number to return. Default: `1`. Increment to paginate through large workspace lists. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***

### update

`workspaces.update`

Updates the name, description, kind, or account product association of an existing workspace using the Platform MCP.

**Risk:** `write`

```ts theme={null}
await corsair.mondaymcp.api.workspaces.update({});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `id` | `string` | Yes | The ID of the workspace to update. Use list\_workspaces to find workspace IDs. |
| `attributeName` | `string` | No | The new name for the workspace. |
| `attributeDescription` | `string` | No | The new description for the workspace. |
| `attributeKind` | `string` | No | The new kind for the workspace. One of: `open`, `closed`, or `template`. |
| `attributeAccountProductId` | `number` | No | The target account product ID to move the workspace to. |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `content` | `object[]` | Yes | — |
| `isError` | `boolean` | No | — |

> [accordion] content full type
>
> ```ts theme={null}
> {
>   type?: string,
>   text?: string
> }[]
> ```

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.