> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Monday.com

**Authentication:** OAuth or API token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Show me every item assigned to me across boards with status `Stuck`.
* Update the priority on items in the `Q2 Roadmap` board that have a due date this week.
* Pull the status breakdown for the `Marketing Campaigns` board.

## Available Tools

#### list\_boards

List boards with filtering by kind, state, workspace, and pagination support

#### get\_board

Get detailed board information by ID including columns, groups, and permissions

#### create\_board

Create a new board with specified name, kind, workspace, and optional template

#### update\_board

Update board properties like name, description, or communication settings

#### archive\_board

Archive board to hide from active view while preserving all data

#### delete\_board

Permanently delete board and all its data (irreversible operation)

#### duplicate\_board

Duplicate board with structure, items, or full data including updates

#### list\_items

List items with filtering by IDs, pagination, and newest first sorting

#### get\_item

Get detailed item information by ID including column values and metadata

#### create\_item

Create a new item in a board with name and optional column values

#### update\_item\_column\_values

Update multiple column values for an item in a single operation

#### change\_column\_value

Change a single column value for an item

#### archive\_item

Archive item to hide from active view while preserving all data

#### delete\_item

Permanently delete item and all its data (irreversible operation)

#### move\_item\_to\_group

Move item to a different group within the same board

#### duplicate\_item

Duplicate item with same column values and optionally include updates

#### create\_subitem

Create a subitem under an existing item for hierarchical task organization

#### clear\_item\_updates

Clear all updates and comments from an item (irreversible operation)

#### list\_updates

List updates with pagination support

#### create\_update

Create a new update (comment/post) on an item

#### edit\_update

Edit an existing update to modify its text content

#### delete\_update

Permanently delete an update and all its replies (irreversible operation)

#### like\_update

Like an update to show appreciation or agreement

#### list\_users

List users with filtering by kind, status, and pagination support

#### get\_user

Get detailed user information by user ID including profile and status

#### get\_current\_user

Get information about the currently authenticated user

#### add\_users\_to\_board

Add users to a board as owners or subscribers

#### remove\_users\_from\_board

Remove users from a board, revoking their access

#### list\_workspaces

List workspaces with filtering by kind, state, and other options

#### create\_workspace

Create a new workspace with specified name, kind (open/closed), and optional description

#### list\_teams

List all teams in the account with member details

#### create\_team

Create a new team with specified name and optional initial members

#### list\_tags

List all tags in the account with details like name and color

#### create\_or\_get\_tag

Create a new tag or get existing tag by name

#### list\_folders

List all folders in workspaces with hierarchical organization details

#### create\_folder

Create a new folder in a workspace to organize boards hierarchically

#### create\_item\_by\_board\_name

Create an item in a board by board name. Resolves board name to ID, fetches board structure (columns/groups), and creates the item.