monday

Learn how to use monday with Composio

Overview

SLUG: MONDAY

Description

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

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string
bearer_token
string

Connecting to monday

Create an auth config

Use the dashboard to create an auth config for the monday toolkit. This allows you to connect multiple monday accounts to Composio for agents to use.

1

Select App

Navigate to monday.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create monday Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2
3# Replace these with your actual values
4monday_auth_config_id = "ac_YOUR_MONDAY_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/application
6
7composio = Composio()
8
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11 connection_request = composio.connected_accounts.initiate(
12 user_id=user_id,
13 auth_config_id=auth_config_id,
14 )
15
16 print(
17 f"Visit this URL to authenticate monday: {connection_request.redirect_url}"
18 )
19
20 # This will wait for the auth flow to be completed
21 connection_request.wait_for_connection(timeout=15)
22 return connection_request.id
23
24
25connection_id = authenticate_toolkit(user_id, monday_auth_config_id)
26
27# You can also verify the connection status using:
28connected_account = composio.connected_accounts.get(connection_id)
29print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the monday toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["MONDAY"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Add users to board

Description

Adds users to a monday.com board with a specified role.

Action Parameters

board_id
integerRequired
kind
stringDefaults to subscriber
user_ids
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add users to team

Description

Tool to add users to a monday.com team. use when updating team membership by adding user(s).

Action Parameters

team_id
integerRequired
user_ids
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add users to workspace

Description

Tool to add one or more users to a workspace. use when inviting existing users to collaborate in a workspace.

Action Parameters

kind
stringDefaults to subscriber
user_ids
arrayRequired
workspace_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Archive board

Description

Archives a specified, existing, and unarchived board in monday.com; archived boards can typically be restored later.

Action Parameters

board_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Archive item

Description

Archives an existing monday.com item, moving it from active board views to the archive where it can be potentially restored.

Action Parameters

item_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Archive workspace

Description

Tool to archive a monday.com workspace. use when you want to soft-remove a workspace from view.

Action Parameters

workspace_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Change simple column value

Description

Changes a specific column's value for a monday.com item using a simple string, suitable for text, status, or dropdown columns; can create new labels if `create labels if missing` is true for status/dropdown columns.

Action Parameters

board_id
integerRequired
column_id
stringRequired
create_labels_if_missing
boolean
item_id
integerRequired
value
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a Monday board

Description

Creates a monday.com board; `template id` if used must be accessible, and `folder id` must be in `workspace id` if both are provided.

Action Parameters

board_kind
stringRequired
board_name
stringRequired
board_owner_ids
array
board_subscriber_ids
array
board_subscriber_teams_ids
array
description
string
folder_id
integer
template_id
integer
workspace_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create column

Description

Creates a new column with a specified type and title on a monday.com board.

Action Parameters

after_column_id
string
board_id
integerRequired
column_type
stringRequired
defaults
string
description
string
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create doc

Description

Tool to create a new doc in monday.com. use when you need to add a doc to a workspace or into a doc column on an item.

Action Parameters

column_id
string
item_id
integer
kind
string
name
string
workspace_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create group

Description

Creates a new group with the given `group name` on an existing monday.com board, identified by its `board id`.

Action Parameters

board_id
integerRequired
group_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create item

Description

Creates a new item on a monday.com board, optionally assigning it to a group and setting column values.

Action Parameters

board_id
integerRequired
column_values
string
group_id
string
item_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create notification

Description

Tool to send a notification to a user. use when you need to alert a user about a board, item, or update. call after obtaining the user and target ids.

Action Parameters

target_id
integerRequired
target_type
stringRequired
text
stringRequired
user_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create tag

Description

Tool to create a new tag or return an existing tag. use when you need to label items with color-coded tags on a public or private board.

Action Parameters

board_id
integer
tag_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create update

Description

Tool to create a new update for an item or reply to an existing update. use after determining the target item or update to comment on.

Action Parameters

body
stringRequired
item_id
integer
mentions_list
array
original_creation_date
string
parent_id
integer
use_app_info
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Invite and create a Monday user

Description

Tool to invite and create a new user. use when you need to programmatically add new users to your monday account.

Action Parameters

emails
arrayRequired
product
string
user_role
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a Monday workspace

Description

Tool to create a monday.com workspace. use when you need to programmatically add a workspace after planning your project structure.

Action Parameters

account_product_id
string
description
string
kind
stringRequired
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete asset

Description

Tool to remove uploaded files. since monday.com doesn't provide a direct asset deletion api, this tool deletes the enclosing update or clears files from a file column.

Action Parameters

asset_id
integerRequired
board_id
integer
column_id
string
item_id
integer
target
string
update_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete board

Description

Tool to permanently delete a board from your monday.com account. use when you need to remove a board permanently after verifying its id. this action cannot be undone.

Action Parameters

board_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete column

Description

Deletes a specified column from a monday.com board; this action is destructive and cannot be undone via the api.

Action Parameters

board_id
integerRequired
column_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete doc

Description

Tool to delete a monday.com doc by its id. use when you need to remove a doc that is no longer needed.

Action Parameters

doc_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete group

Description

Permanently deletes an existing group (and its items) from an existing board in monday.com.

Action Parameters

board_id
integerRequired
group_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete item

Description

Permanently deletes an existing monday.com item; this action is irreversible via the api.

Action Parameters

item_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete tag

Description

Tool to process deletion of a tag. note: monday.com's public api does not currently support permanently deleting a tag across the account. as a best-effort, this action validates that the tag exists and returns its id.

Action Parameters

tag_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete team

Description

Tool to delete an existing team; use when you need to permanently remove a team by its id after confirming it’s no longer needed.

Action Parameters

team_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete update

Description

Tool to delete an update by its id. use when an update is no longer relevant. use after confirming deletion is irreversible.

Action Parameters

update_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete user

Description

Tool to deactivate or remove a user by id. use when you need to permanently disable a user's access; operation cannot be undone.

Action Parameters

user_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete workspace

Description

Tool to permanently delete a workspace by its id. use when a workspace is no longer needed. use after confirming deletion is irreversible.

Action Parameters

workspace_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Duplicate item

Description

Duplicates an item on a monday.com board, optionally including its updates.

Action Parameters

board_id
integerRequired
item_id
integerRequired
with_updates
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get account info

Description

Tool to retrieve account metadata and settings. use when you need to inspect account configuration before performing account-scoped operations after authenticating.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get asset

Description

Tool to retrieve metadata for an uploaded asset. use when you need to fetch file details by its id after upload.

Action Parameters

asset_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get doc

Description

Tool to retrieve details of a specific doc. use when you need to fetch a document by its id after confirming the doc id.

Action Parameters

doc_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get group details

Description

Retrieves details (id, title, color, archived/deleted status) for a specific group on an accessible monday.com board.

Action Parameters

board_id
integerRequired
group_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get current user

Description

Tool to fetch the current authenticated user's profile and permissions. use when you need to retrieve user metadata before performing other operations.

Action Parameters

api_version
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get tags

Description

Tool to retrieve tags from the account. use when you need to list all tags or filter by specific ids.

Action Parameters

ids
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get teams

Description

Tool to retrieve teams from monday.com. use when you need an overview of teams in your account.

Action Parameters

ids
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get item updates

Description

Tool to retrieve updates for a specific item. use when you need to fetch the conversation history tied to an item.

Action Parameters

item_id
integerRequired
limit
integerDefaults to 25
page
integerDefaults to 1

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get webhooks

Description

Tool to retrieve webhooks for a board. use when you need to list all webhooks on a board.

Action Parameters

app_webhooks_only
boolean
board_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get workspaces

Description

Tool to retrieve workspaces. use when you need to list workspaces with optional filtering, pagination, or ordering after authentication.

Action Parameters

ids
array
kind
string
limit
integer
order_by
string
page
integer
state
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List board items

Description

Retrieves id, name, and state for all items on a specified monday.com board.

Action Parameters

board_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Monday boards

Description

Retrieves a list of boards from a monday.com account, supporting pagination and filtering by state.

Action Parameters

limit
integerDefaults to 25
page
integerDefaults to 1
state
stringDefaults to active

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List columns

Description

Lists all columns and their properties for a specified monday.com `board id`; the board must exist.

Action Parameters

board_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Monday docs

Description

Tool to list docs. use when you need to retrieve docs accessible in an account or workspace.

Action Parameters

ids
array
limit
integerDefaults to 25
object_ids
array
order_by
string
page
integerDefaults to 1
workspace_ids
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List groups

Description

Tool to retrieve all groups of a specified board. use when you need to list groups on a board after confirming its board id.

Action Parameters

board_id
integerRequired
group_ids
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List items

Description

Retrieves specified subitems from monday.com using their ids, returning the raw json response.

Action Parameters

item_ids
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List team members

Description

Tool to list members of a specified team. use when you need to retrieve all users in a given monday.com team after confirming its team id.

Action Parameters

team_ids
array
user_filters
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List users

Description

Retrieves a list of users from monday.com; an empty user list in the response 'data' field does not signify action failure.

Action Parameters

limit
integerDefaults to 25
page
integerDefaults to 1

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Move item to board

Description

Moves a monday.com item to a specified board and group; requires the item, target board, and target group to exist.

Action Parameters

board_id
integerRequired
group_id
stringRequired
item_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Move item to group

Description

Moves an item to a different group on the same monday.com board; the item and group must exist.

Action Parameters

group_id
stringRequired
item_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove users from team

Description

Tool to remove users from a monday.com team. use when updating team membership by removing user(s).

Action Parameters

team_id
integerRequired
user_ids
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove users from workspace

Description

Tool to remove users from a workspace. use when revoking access for specific users in a workspace.

Action Parameters

user_ids
arrayRequired
workspace_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update board

Description

Updates a specified attribute of an existing board on monday.com.

Action Parameters

board_attribute
stringRequired
board_id
integerRequired
new_value
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update column

Description

Tool to update column title or description. use when modifying a column’s metadata after creation.

Action Parameters

board_id
integerRequired
column_id
stringRequired
column_property
stringRequired
value
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update a doc

Description

Tool to update a doc's title or append markdown content. use when renaming docs or adding markdown blocks to existing docs.

Action Parameters

after_block_id
string
doc_id
integerRequired
markdown
string
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update group

Description

Tool to update an existing group on a board. use when you need to modify a group's attribute (title, color, or position) after confirming the group id.

Action Parameters

board_id
integerRequired
group_attribute
stringRequired
group_id
stringRequired
new_value
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update item

Description

Tool to update an existing item's column value on monday.com. use when setting complex column types like timeline or people.

Action Parameters

board_id
integerRequired
column_id
stringRequired
create_labels_if_missing
boolean
item_id
integerRequired
value
Required

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update tag

Description

Tool to return a tag's details or best-effort "rename" by creating or getting a tag with the requested name. the monday api does not support updating existing tag name/color.

Action Parameters

color
string
name
string
tag_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update team

Description

Tool to update a team's details in monday.com. use after identifying the team and desired changes.

Action Parameters

is_guest_team
boolean
name
string
parent_team_id
integer
subscriber_ids
array
team_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Edit update

Description

Tool to edit an existing update's content. use when you need to correct or change a previously posted update.

Action Parameters

body
stringRequired
update_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update user

Description

Tool to update a user on monday.com. use when changing profile attributes like name, email, or department; ensure user id is valid.

Action Parameters

birthday
string
department
string
email
string
join_date
string
location
string
mobile_phone
string
name
string
phone
string
title
string
user_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update a Monday workspace

Description

Tool to update a monday.com workspace. use when you need to modify the name, description, visibility, or product placement of an existing workspace.

Action Parameters

account_product_id
string
description
string
kind
string
name
string
workspace_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Upload Asset

Description

Tool to upload a file to an update or file column. use when you need to attach a file to an existing update or file column.

Action Parameters

column_id
string
file_path
stringRequired
item_id
integer
target
stringRequired
update_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired