# monday — Pipedream Connect

> monday.com is a powerful project management system — a complete Work OS designed to help your team complete projects efficiently, collaborate effectively, and grow online.

- API slug: `monday` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Productivity
- Website: https://monday.com
- This page (HTML): https://pipedream.com/apps/monday
- Tools: 18 actions · 10 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: monday`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "monday",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Create an Update:
const result = await mcp.callTool({
  name: "monday-create-update",
  arguments: {
    updateBody: "Update Body",
    boardId: "Board ID",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a monday endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.monday.com/v2

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkubW9uZGF5LmNvbS92Mg?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "monday-create-update",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    monday: { authProvisionId: "apn_xxxxxxx" },
    updateBody: "Update Body",
    boardId: "Board ID",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (18)

### `monday-create-update` — Create an Update (Write)

Post an update (a comment) on an item, or reply to an existing update. Use to add a note to an item's activity feed; this changes no column value — use Update Column Values for that. Set Board ID, Item ID and Update Body, and set Parent Update ID only when replying to an existing update rather than…

Full schema: https://pipedream.com/apps/monday/actions/create-update.md

### `monday-create-board` — Create Board (Write)

Create a new board in a workspace. Use when you need a new board before adding groups, columns or items to it. Set Board Name and Board Kind (public, private or share); if you omit Workspace ID the board is created in the Main Workspace. Example: Board Name Q3 Campaigns, Board Kind public. Returns…

Full schema: https://pipedream.com/apps/monday/actions/create-board.md

### `monday-create-column` — Create Column (Write)

Add a column to an existing board. Use when a board is missing a field you need before setting values with Create Item or Update Column Values. Set Board ID, Title and Column Type (e.g. status, text, date, numbers). Custom Labels (Defaults) is accepted only when Column Type is status or dropdown…

Full schema: https://pipedream.com/apps/monday/actions/create-column.md

### `monday-create-group` — Create Group (Write)

Create a group (a titled section of rows) on a board. Use when you need somewhere to put new rows before calling Create Item, which takes an optional Group ID. Set Board ID and Group Name. Example: Board ID 2419687965, Group Name In Progress. Returns the new group's ID as a string (e.g…

Full schema: https://pipedream.com/apps/monday/actions/create-group.md

### `monday-create-item` — Create Item (Write)

Create an item (a row) on a board. Use for a top-level row; use Create Subitem for a row nested under an existing item. Set Board ID and Item Name, and optionally Group ID and Column Values. Call List Columns first to get the column IDs and the labels a status or dropdown column accepts. Example…

Full schema: https://pipedream.com/apps/monday/actions/create-item.md

### `monday-create-subitem` — Create Subitem (Write)

Create a subitem nested under an existing item. Use when the row belongs to a parent item; use Create Item for a top-level row. Set Board ID (the parent item's board), Parent Item ID and Item Name. Gotcha: subitems live on a separate subitems board, so Column Values must use that board's column IDs…

Full schema: https://pipedream.com/apps/monday/actions/create-subitem.md

### `monday-get-board-items-page` — Get Board Items Page (Read-only)

List every item (row) on a board, following the API's cursor automatically so all pages are returned in a single call — you do not need to paginate. Use when you want the whole board; use Get Items By Column Value to filter server-side by one column, which is far cheaper on a large board. Set Board…

Full schema: https://pipedream.com/apps/monday/actions/get-board-items-page.md

### `monday-get-column-values` — Get Column Values (Read-only)

Read the column values of one item. Use when you already have an Item ID and want its field values; use Get Items By Column Value to search for items by a value instead. Set Board ID and Item ID; leave Column IDs empty to return every column, or pass specific column IDs from List Columns. Example…

Full schema: https://pipedream.com/apps/monday/actions/get-column-values.md

### `monday-get-items-by-column-value` — Get Items By Column Value (Read-only)

Find every item on a board whose column matches a value, following the API's cursor automatically so all matches are returned in a single call. Use to look up items by a field instead of pulling the whole board with Get Board Items Page. Set Board ID, Column and Value. For a status or dropdown…

Full schema: https://pipedream.com/apps/monday/actions/get-items-by-column-value.md

### `monday-list-board-id-options` — List Board ID Options (Read-only)

List the account's boards as { value, label } option pairs, to discover a Board ID to pass to other actions. Use when you know a board by name but need its ID; use List Boards when you want each board's full details instead. Example: call with Page 1; returns e.g. [{ "value": "2419687965", "label"…

Full schema: https://pipedream.com/apps/monday/actions/list-board-id-options.md

### `monday-list-board-ids-options` — List Board IDs Options (Read-only)

List the account's boards as { value, label } option pairs, to discover the Board IDs to pass to actions that filter across several boards, such as List Boards. Use when you know boards by name but need their IDs. Example: call with Page 1; returns e.g. [{ "value": "2419687965", "label": "Q3…

Full schema: https://pipedream.com/apps/monday/actions/list-board-ids-options.md

### `monday-list-boards` — List Boards (Read-only)

List boards with their full details — columns, groups, owners, subscribers, tags and workspace. Use when you need board metadata; use List Board ID Options when you only need an ID and a name, which returns a far smaller response. Narrow the results with Board IDs, Workspace IDs, Board Kind and…

Full schema: https://pipedream.com/apps/monday/actions/list-boards.md

### `monday-list-columns` — List Columns (Read-only)

List the columns of a board, including each column's ID, type, and the labels a status or dropdown column accepts. Use this to discover the column IDs and values required by Create Item, Update Column Values and Get Items By Column Value. Set Board ID. Example: returns e.g. [{ "id": "status"…

Full schema: https://pipedream.com/apps/monday/actions/list-columns.md

### `monday-list-updates` — List Updates (Read-only)

List the updates (comments) posted on a board's items, including each update's ID, body and author. Use this to discover the Parent Update ID required by Create an Update when replying to an existing update. Set Board ID. Example: Limit 25, Page 1. Returns an array of update objects, each carrying…

Full schema: https://pipedream.com/apps/monday/actions/list-updates.md

### `monday-list-workspace-id-options` — List Workspace ID Options (Read-only)

List the account's workspaces as { value, label } option pairs, to discover a Workspace ID to pass to Create Board or to filter List Boards. Use when you know a workspace by name but need its ID. Example: call with Page 1; returns e.g. [{ "value": 12345, "label": "Marketing" }]. Returns at most…

Full schema: https://pipedream.com/apps/monday/actions/list-workspace-id-options.md

### `monday-list-workspace-ids-options` — List Workspace IDs Options (Read-only)

List the account's workspaces as { value, label } option pairs, to discover the Workspace IDs to pass to actions that filter across several workspaces, such as List Boards. Use when you know workspaces by name but need their IDs. Example: call with Page 1; returns e.g. [{ "value": 12345, "label"…

Full schema: https://pipedream.com/apps/monday/actions/list-workspace-ids-options.md

### `monday-update-column-values` — Update Column Values (Write)

Set one or more column values on an existing item. Use for any field change except the item's name — this mutation cannot change it, so use Update Item Name for that. Set Board ID, Item ID and Column Values as column ID to value pairs; call List Columns first for the column IDs and the labels a…

Full schema: https://pipedream.com/apps/monday/actions/update-column-values.md

### `monday-update-item-name` — Update Item Name (Write)

Rename an existing item. Use for the item's name only — Update Column Values cannot change it, and this action changes nothing else. Set Board ID, Item ID and the new Item Name. Example: Item ID 9876543210, Item Name Website redesign v2. Returns the item's ID as a string. Use Get Board Items Page…

Full schema: https://pipedream.com/apps/monday/actions/update-item-name.md

## Triggers (10)

### `monday-column-value-updated` — Column Value Updated (Instant) (Instant)

Emit new event when a column value is updated on a board. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/column-value-updated.md

### `monday-name-updated` — Name Updated (Instant) (Instant)

Emit new event when an item's name is updated. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/name-updated.md

### `monday-new-board` — New Board Created (Polling)

Emit new event when a board is created in Monday. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/new-board.md

### `monday-new-item` — New Item Created (Instant) (Instant)

Emit new event when a new item is added to a board. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/new-item.md

### `monday-new-subitem` — New Sub-Item Created (Instant) (Instant)

Emit new event when a sub-item is created. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/new-subitem.md

### `monday-new-subitem-update` — New Sub-Item Update (Instant) (Instant)

Emit new event when an update is posted in sub-items. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/new-subitem-update.md

### `monday-new-user` — New User Created (Polling)

Emit new event when a new user is created in Monday. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/new-user.md

### `monday-specific-column-updated` — Specific Column Updated (Instant) (Instant)

Emit new event when a value in the specified column is updated. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/specific-column-updated.md

### `monday-subitem-column-value-updated` — Sub-Item Column Value Updated (Instant) (Instant)

Emit new event when any sub-item column changes. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/subitem-column-value-updated.md

### `monday-subitem-name-updated` — Sub-Item Name Updated (Instant) (Instant)

Emit new event when a sub-item name changes. See the documentation

Full schema: https://pipedream.com/apps/monday/triggers/subitem-name-updated.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt