← Back to all apps
Monday.com logo

Monday.com

Open in ChatGPT →

Overview

Tools Available35
CategoryProductivity

Manage work in monday.com

Available Tools

Monday.com provides 35 tools that can be used to interact with its services.

All Monday Api

all_monday_api
Full Description

Execute any monday.com API operation by generating GraphQL queries and mutations dynamically. Make sure you ask only for the fields you need and nothing more. When providing the query/mutation - use get_graphql_schema and get_type_details tools first to understand the schema before crafting your query.

Parameters

Required
querystring

Custom GraphQL query/mutation. you need to provide the full query / mutation

variablesstring

JSON string containing the variables for the GraphQL operation

All Widgets Schema

all_widgets_schema
Full Description

Fetch complete JSON Schema 7 definitions for all available widget types in monday.com.

This tool is essential before creating widgets as it provides:

  • Complete schema definitions for all supported widgets
  • Required and optional fields for each widget type
  • Data type specifications and validation rules
  • Detailed descriptions of widget capabilities

Use this tool when you need to:

  • Understand widget configuration requirements before creating widgets
  • Validate widget settings against official schemas
  • Plan widget implementations with proper data structures

The response includes JSON Schema 7 definitions that describe exactly what settings each widget type accepts.

Board Insights

board_insights
Full Description

This tool allows you to calculate insights about board's data by filtering, grouping and aggregating columns. For example, you can get the total number of items in a board, the number of items in each status, the number of items in each column, etc. Use this tool when you need to get a summary of the board's data, for example, you want to know the total number of items in a board, the number of items in each status, the number of items in each column, etc.[REQUIRED PRECONDITION]: Before using this tool, if new columns were added to the board or if you are not familiar with the board's structure (column IDs, column types, status labels, etc.), first use get_board_info to understand the board metadata. This is essential for constructing proper filters and knowing which columns are available.[IMPORTANT]: For some columns, human-friendly label is returned inside 'LABEL_<column_id' field. E.g. for column with id 'status_123' the label is returned inside 'LABEL_status_123' field.

Parameters

Required
boardIdnumber

The id of the board to get insights for

Optional
aggregationsarray

The aggregations to get. Before sending the aggregations, use get_board_info tool to check "aggregationGuidelines" key for information. Transformative functions and plain columns (no function) must be in group by. [REQUIRED PRECONDITION]: Either send this field or the stringified version of it.

aggregationsStringifiedstring

**ONLY FOR MICROSOFT COPILOT**: The aggregations to get. Send this as a stringified JSON array of "aggregations" field. Read "aggregations" field description for details how to use it.

filtersarray

The configuration of filters to apply on the items. Before sending the filters, use get_board_info tool to check "filteringGuidelines" key for filtering by the column.

filtersOperatorstring

The logical operator to use for the filters

Options:andor
Default: and
filtersStringifiedstring

**ONLY FOR MICROSOFT COPILOT**: The filters to apply on the items. Send this as a stringified JSON array of "filters" field. Read "filters" field description for details how to use it.

groupByarray

The columns to group by. All columns in the group by must be in the aggregations as well without a function.

limitnumber

The limit of the results

Default: 1000
orderByarray

The columns to order by, will control the order of the items in the response

orderByStringifiedstring

**ONLY FOR MICROSOFT COPILOT**: The order by to apply on the items. Send this as a stringified JSON array of "orderBy" field. Read "orderBy" field description for details how to use it.

Change Item Column Values

change_item_column_values
Full Description

Change the column values of an item in a monday.com board

Parameters

Required
boardIdnumber

The ID of the board that contains the item to be updated

columnValuesstring

A string containing the new column values for the item following this structure: {\"column_id\": \"value\",... you can change multiple columns at once, note that for status column you must use nested value with 'label' as a key and for date column use 'date' as key} - example: "{\"text_column_id\":\"New text\", \"status_column_id\":{\"label\":\"Done\"}, \"date_column_id\":{\"date\":\"2023-05-25\"}, \"phone_id\":\"123-456-7890\", \"email_id\":\"test@example.com\"}"

itemIdnumber

The ID of the item to be updated

Create Board

create_board
Full Description

Create a monday.com board

Parameters

Required
boardNamestring

The name of the board to create

Optional
boardDescriptionstring

The description of the board to create

boardKindstring

The kind of board to create

Options:privatepublicshare
Default: public
workspaceIdstring

The ID of the workspace to create the board in

Create Column

create_column
Full Description

Create a new column in a monday.com board

Parameters

Required
boardIdnumber

The id of the board to which the new column will be added

columnTitlestring

The title of the column to be created

columnTypestring

The type of the column to be created

Options:auto_numberboard_relationbuttoncheckboxcolor_pickercountrycreation_logdatedependencydirect_docdocdropdownemailfileformulagrouphourintegrationitem_assigneesitem_idlast_updatedlinklocationlong_textmirrornamenumberspeoplephoneprogressratingstatussubtaskstagsteamtexttime_trackingtimelineunsupportedvoteweekworld_clock
Optional
columnDescriptionstring

The description of the column to be created

columnSettingsstring

Column-specific configuration settings as a JSON string. Use the get_column_type_info tool to fetch the JSON schema for the given column type.

Create Dashboard

create_dashboard
Full Description

Use this tool to create a new monday.com dashboard that aggregates data from one or more boards. Dashboards provide visual representations of board data through widgets and charts.

Use this tool when users want to:

  • Create a dashboard to visualize board data
  • Aggregate information from multiple boards
  • Set up a data visualization container for widgets

Parameters

Required
board_idsarray

List of board IDs as strings (min 1 element)

namestring

Human-readable dashboard title (UTF-8 chars)

workspace_idstring

ID of the workspace that will own the dashboard

Optional
board_folder_idstring

Optional folder ID within workspace to place this dashboard (if not provided, dashboard will be placed in workspace root)

kindstring

Visibility level: PUBLIC or PRIVATE

Options:PRIVATEPUBLIC
Default: PUBLIC

Create Doc

create_doc
Full Description

Create a new monday.com doc either inside a workspace or attached to an item (via a doc column). After creation, the provided markdown will be appended to the document.

LOCATION TYPES:

  • workspace: Creates a document in a workspace (requires workspace_id, optional doc_kind, optional folder_id)
  • item: Creates a document attached to an item (requires item_id, optional column_id)

USAGE EXAMPLES:

  • Workspace doc: { location: "workspace", workspace_id: 123, doc_kind: "private" , markdown: "..." }
  • Workspace doc in folder: { location: "workspace", workspace_id: 123, folder_id: 17264196 , markdown: "..." }
  • Item doc: { location: "item", item_id: 456, column_id: "doc_col_1" , markdown: "..." }

Parameters

Required
doc_namestring

Name for the new document.

locationstring

Location where the document should be created - either in a workspace or attached to an item

Options:workspaceitem
markdownstring

Markdown content that will be imported into the newly created document as blocks.

Optional
column_idstring

[OPTIONAL - use only when location="item"] ID of an existing "doc" column on the board which contains the item. If not provided, the tool will create a new doc column automatically when creating a doc on an item.

doc_kindstring

[OPTIONAL - use only when location="workspace"] Document kind (public/private/share). Defaults to public.

Options:privatepublicshare
folder_idnumber

[OPTIONAL - use only when location="workspace"] Optional folder ID to place the document inside a specific folder

item_idnumber

[REQUIRED - use only when location="item"] Item ID to attach the new document to

workspace_idnumber

[REQUIRED - use only when location="workspace"] Workspace ID under which to create the new document

Create Folder

create_folder
Full Description

Create a new folder in a monday.com workspace

Parameters

Required
namestring

The name of the folder to be created

workspaceIdstring

The ID of the workspace where the folder will be created

Optional
colorstring

The color of the folder

Options:AQUAMARINEBRIGHT_BLUEBRIGHT_GREENCHILI_BLUEDARK_ORANGEDARK_PURPLEDARK_REDDONE_GREENINDIGOLIPSTICKNULLPURPLESOFIA_PINKSTUCK_REDSUNSETWORKING_ORANGE
customIconstring

The custom icon of the folder

Options:FOLDERMOREBELOWMOREBELOWFILLEDNULLWORK
fontWeightstring

The font weight of the folder

Options:FONT_WEIGHT_BOLDFONT_WEIGHT_LIGHTFONT_WEIGHT_NORMALFONT_WEIGHT_VERY_LIGHTNULL
parentFolderIdstring

The ID of the parent folder

Create Form

create_form
Full Description

Create a monday.com form. This will create a new form as well as a new board for which the form’s responses will be stored. The returned board_id is the ID of the board that was created while the returned formToken can be used for all future queries and mutations to continue editing the form.

Parameters

Required
destination_workspace_idstring

The workspace in which the form will be created in.

Optional
board_kindstring

The board kind to create for the board in which the form will create items in.

Options:privatepublicshare
board_owner_idsarray

Array of user IDs who will have owner permissions on the board in which the form will create items in.

board_owner_team_idsarray

Array of team IDs whose members will have owner permissions on the board in which the form will create items in.

board_subscriber_idsarray

Array of user IDs who will receive notifications about board activity for the board in which the form will create items in.

board_subscriber_teams_idsarray

Array of team IDs whose members will receive notifications about board activity for the board in which the form will create items in.

destination_folder_idstring

The folder in which the form will be created under.

destination_folder_namestring

The name of the folder in which the form will be created in.

destination_namestring

The name of the board that will be created to store the form responses in.

Create Group

create_group
Full Description

Create a new group in a monday.com board. Groups are sections that organize related items. Use when users want to add structure, categorize items, or create workflow phases. Groups can be positioned relative to existing groups and assigned predefined colors. Items will always be created in the top group and so the top group should be the most relevant one for new item creation

Parameters

Required
boardIdstring

The ID of the board to create the group in

groupNamestring

The name of the new group (maximum 255 characters)

Optional
groupColorstring

The color for the group. Must be one of the predefined Monday.com group colors: #037f4c, #00c875, #9cd326, #cab641, #ffcb00, #784bd1, #9d50dd, #007eb5, #579bfc, #66ccff, #bb3354, #df2f4a, #ff007f, #ff5ac4, #ff642e, #fdab3d, #7f5347, #c4c4c4, #757575

Options:#037f4c#00c875#9cd326#cab641#ffcb00#784bd1#9d50dd#007eb5#579bfc#66ccff#bb3354#df2f4a#ff007f#ff5ac4#ff642e#fdab3d#7f5347#c4c4c4#757575
positionRelativeMethodstring

Whether to position the new group before or after the relativeTo group

Options:after_atbefore_at
relativeTostring

The ID of the group to position this new group relative to

Create Item

create_item
Full Description

Create a new item with provided values, create a subitem under a parent item, or duplicate an existing item and update it with new values. Use parentItemId when creating a subitem under an existing item. Use duplicateFromItemId when copying an existing item with modifications.[REQUIRED PRECONDITION]: Before using this tool, if new columns were added to the board or if you are not familiar with the board's structure (column IDs, column types, status labels, etc.), first use get_board_info to understand the board metadata. This is essential for constructing proper column values and knowing which columns are available.

Parameters

Required
boardIdnumber

The id of the board to which the new item will be added

columnValuesstring

A string containing the new column values for the item following this structure: {\"column_id\": \"value\",... you can change multiple columns at once, note that for status column you must use nested value with 'label' as a key and for date column use 'date' as key} - example: "{\"text_column_id\":\"New text\", \"status_column_id\":{\"label\":\"Done\"}, \"date_column_id\":{\"date\":\"2023-05-25\"},\"dropdown_id\":\"value\", \"phone_id\":\"123-456-7890\", \"email_id\":\"test@example.com\"}"

namestring

The name of the new item to be created, must be relevant to the user's request

Optional
duplicateFromItemIdnumber

The id of existing item to duplicate and update with new values (only provide when duplicating)

groupIdstring

The id of the group id to which the new item will be added, if its not clearly specified, leave empty

parentItemIdnumber

The id of the parent item under which the new subitem will be created

Create Update

create_update
Full Description

Create a new update (comment/post) on a monday.com item. Updates can be used to add comments, notes, or discussions to items. You can optionally mention users, teams, or boards in the update.

Parameters

Required
bodystring

The update text to be created. Do not use @ to mention users, use the mentionsList field instead.

itemIdnumber

The id of the item to which the update will be added

Optional
mentionsListstring

Optional JSON array of mentions in the format: [{"id": "123", "type": "User"}, {"id": "456", "type": "Team"}]. Valid types are: User, Team, Board, Project

Create Widget

create_widget
Full Description

Create a new widget in a dashboard or board view with specific configuration settings.

This tool creates data visualization widgets that display information from monday.com boards: Parent Containers:

  • DASHBOARD: Place widget in a dashboard (most common use case)
  • BOARD_VIEW: Place widget in a specific board view

Critical Requirements: 1. Schema Compliance: Widget settings MUST conform to the JSON schema for the specific widget type 2. Use all_widgets_schema first: Always fetch widget schemas before creating widgets 3. Validate settings: Ensure all required fields are provided and data types match

Workflow: 1. Use 'all_widgets_schema' to get schema definitions 2. Prepare widget settings according to the schema 3. Use this tool to create the widget

Parameters

Required
parent_container_idstring

ID of the parent container (dashboard ID or board view ID)

parent_container_typestring

Type of parent container: DASHBOARD or BOARD_VIEW

Options:BOARD_VIEWDASHBOARD
widget_kindstring

Type of widget to create: i.e CHART, NUMBER, BATTERY

Options:BATTERYCALENDARCHARTGANTTNUMBER
widget_namestring

Widget display name (1-255 UTF-8 chars)

Optional
settingsobject

Widget-specific settings as JSON object conforming to widget schema. Use all_widgets_schema tool to get the required schema for each widget type.

settingsStringifiedstring

**ONLY FOR MICROSOFT COPILOT**: The settings object. Send this as a stringified JSON of "settings" field. Read "settings" field description for details how to use it.

Create Workspace

create_workspace
Full Description

Create a new workspace in monday.com

Parameters

Required
namestring

The name of the new workspace to be created

workspaceKindstring

The kind of workspace to create

Options:closedopentemplate
Optional
accountProductIdstring

The account product ID associated with the workspace

descriptionstring

The description of the new workspace

Form Questions Editor

form_questions_editor
Full Description

Create, update, or delete a question in a monday.com form

Parameters

Required
actionstring

The type of operation to perform on the question. Can delete, update, or create. When updating or deleting a question, the questionId is required. When creating or updating a question, the question object is required. When updating, the question is a patch object, meaning that only the fields that are provided will be updated.

Options:deleteupdatecreate
formTokenstring

The unique identifier token for the form. Required for all form-specific operations.

Optional
questionobject

The question object containing all properties for creation or update. When creating a question, the title is required.

questionIdstring

The unique identifier for the question. Used to target specific questions within a form.

questionStringifiedstring

**ONLY FOR MICROSOFT COPILOT**: The question object. Send this as a stringified JSON of "question" field. Read "question" field description for details how to use it.

Get Board Activity

get_board_activity
Full Description

Get board activity logs for a specified time range (defaults to last 30 days)

Parameters

Required
boardIdnumber

The id of the board to get activity for

Optional
fromDatestring

Start date for activity range (ISO8601DateTime format). Defaults to 30 days ago

toDatestring

End date for activity range (ISO8601DateTime format). Defaults to now

Get Board Info

get_board_info
Full Description

Get comprehensive board information including metadata, structure, owners, and configuration

Parameters

Required
boardIdnumber

The id of the board to get information for

Get Board Items Page

get_board_items_page
Full Description

Get all items from a monday.com board with pagination support and optional column values. Returns structured JSON with item details, creation/update timestamps, and pagination info. Use the 'nextCursor' parameter from the response to get the next page of results when 'has_more' is true.[REQUIRED PRECONDITION]: Before using this tool, if new columns were added to the board or if you are not familiar with the board's structure (column IDs, column types, status labels, etc.), first use get_board_info to understand the board metadata. This is essential for constructing proper filters and knowing which columns are available.

Parameters

Required
boardIdnumber

The id of the board to get items from

Optional
columnIdsarray

The ids of the item columns and subitem columns to get, can be used to reduce the response size when user asks for specific columns. Works only when includeColumns is true. If not provided, all columns will be returned

cursorstring

The cursor to get the next page of items, use the nextCursor from the previous response. If the nextCursor was null, it means there are no more items to get

filtersarray

The configuration of filters to apply on the items. Before sending the filters, use get_board_info tool to check "filteringGuidelines" key for filtering by the column.

filtersOperatorstring

The operator to use for the filters

Options:andor
Default: and
filtersStringifiedstring

**ONLY FOR MICROSOFT COPILOT**: The filters to apply on the items. Send this as a stringified JSON array of "filters" field. Read "filters" field description for details how to use it.

includeColumnsboolean

Whether to include column values in the response. PERFORMANCE OPTIMIZATION: Only set this to true when you actually need the column data. Excluding columns significantly reduces token usage and improves response latency. If you only need to count items, get item IDs/names, or check if items exist, keep this false.

Default: False
includeSubItemsboolean

Whether to include sub items in the response. PERFORMANCE OPTIMIZATION: Only set this to true when you actually need the sub items data.

Default: False
itemIdsarray

The ids of the items to get. The count of items should be less than 100.

limitnumber

The number of items to get

Default: 25
orderByarray

The columns to order by, will control the order of the items in the response

orderByStringifiedstring

**ONLY FOR MICROSOFT COPILOT**: The order by to apply on the items. Send this as a stringified JSON array of "orderBy" field. Read "orderBy" field description for details how to use it.

searchTermstring

The search term to use for the search. - Use this when: the user provides a vague, incomplete, or approximate search term (e.g., “marketing campaign”, “John’s task”, “budget-related”), and there isn’t a clear exact compare value for a specific field. - Do not use this when: the user specifies an exact value that maps directly to a column comparison (e.g., name contains "marketing campaign", status = "Done", priority = "High", owner = "Daniel"). In these cases, prefer structured compare filters.

subItemLimitnumber

The number of sub items to get per item. This is only used when includeSubItems is true.

Default: 25

Get Column Type Info

get_column_type_info
Full Description

Retrieves comprehensive information about a specific column type, including JSON schema definition and other metadata. Use this before creating columns with the create_column tool to understand the structure, validation rules, and available properties for column settings.

Parameters

Required
columnTypestring

The column type to retrieve information for (e.g., "text", "status", "date", "numbers")

Options:auto_numberboard_relationbuttoncheckboxcolor_pickercountrycreation_logdatedependencydirect_docdocdropdownemailfileformulagrouphourintegrationitem_assigneesitem_idlast_updatedlinklocationlong_textmirrornamenumberspeoplephoneprogressratingstatussubtaskstagsteamtexttime_trackingtimelineunsupportedvoteweekworld_clock

Get Form

get_form
Full Description

Get a monday.com form by its form token. Form tokens can be extracted from the form’s url. Given a form url, such as https://forms.monday.com/forms/abc123def456ghi789?r=use1, the token is the alphanumeric string that appears right after /forms/ and before the ?. In the example, the token is abc123def456ghi789.

Parameters

Required
formTokenstring

The unique identifier token for the form. Required for all form-specific operations.

Get Graphql Schema

get_graphql_schema
Full Description

Fetch the monday.com GraphQL schema structure including query and mutation definitions. This tool returns available query fields, mutation fields, and a list of GraphQL types in the schema. You can filter results by operation type (read/write) to focus on either queries or mutations.

Parameters

Optional
operationTypestring

Type of operation: "read" for queries, "write" for mutations

Options:readwrite
random_stringstring

Dummy parameter for no-parameter tools

Get Monday Dev Sprints Boards

get_monday_dev_sprints_boards
Full Description

Discover monday-dev sprints boards and their associated tasks boards in your account.

Purpose:

Identifies and returns monday-dev sprints board IDs and tasks board IDs that you need to use with other monday-dev tools. This tool scans your recently used boards (up to 100) to find valid monday-dev sprint management boards.

What it Returns:

  • Pairs of sprints boards and their corresponding tasks boards
  • Board IDs, names, and workspace information for each pair
  • The bidirectional relationship between each sprints board and its tasks board

Note:

Searches recently used boards (up to 100). If none found, ask user to provide board IDs manually.

Get Sprint Summary

get_sprint_summary
Full Description

Get the complete summary and analysis of a sprint.

Purpose:

Unlock deep insights into completed sprint performance.

The sprint summary content including:

  • Scope Management: Analysis of planned vs. unplanned tasks, scope creep
  • Velocity & Performance: Individual velocity, task completion rates, workload distribution per team member
  • Task Distribution: Breakdown of completed tasks by type (Feature, Bug, Tech Debt, Infrastructure, etc.)
  • AI Recommendations: Action items, process improvements, retrospective focus areas

Requirements:

  • Sprint must be completed and must be created after 1/1/2025

Important Note:

When viewing the section "Completed by Assignee", you'll see user IDs in the format "@user-12345678". the 8 digits after the @is the user ID. To retrieve the actual owner names, use the list_users_and_teams tool with the user ID and set includeTeams=false for optimal performance.

Parameters

Required
sprintIdnumber

The ID of the sprint to get the summary for (e.g., "9123456789")

Get Sprints Metadata

get_sprints_metadata
Full Description

Get comprehensive sprint metadata from a monday-dev sprints board including:

Data Retrieved:

A table of sprints with the following information:

  • Sprint ID
  • Sprint Name
  • Sprint timeline (planned from/to dates)
  • Sprint completion status (completed/in-progress/planned)
  • Sprint start date (actual)
  • Sprint end date (actual)
  • Sprint activation status
  • Sprint summary document object ID

Parameters:

  • limit: Number of sprints to retrieve (default: 25, max: 100)

Requires the Main Sprints board ID of the monday-dev containing your sprints.

Parameters

Required
sprintsBoardIdnumber

The ID of the monday-dev board containing the sprints

Optional
limitnumber

The number of sprints to retrieve (default: 25, max: 100)

Default: 25

Get Type Details

get_type_details
Full Description

Get detailed information about a specific GraphQL type from the monday.com API schema

Parameters

Required
typeNamestring

The name of the GraphQL type to get details for

List Users And Teams

list_users_and_teams
Full Description

Tool to fetch users and/or teams data.

MANDATORY BEST PRACTICES: 1. ALWAYS use specific IDs or names when available 2. If no ids available, use name search if possible (USERS ONLY) 3. Use 'getMe: true' to get current user information 4. AVOID broad queries (no parameters) - use only as last resort

REQUIRED PARAMETER PRIORITY (use in this order): 1. getMe

  • STANDALONE

2. userIds 3. name

  • STANDALONE (USERS ONLY, NOT for teams)

4. teamIds + teamsOnly 5. No parameters

  • LAST RESORT

CRITICAL USAGE RULES: • userIds + teamIds requires explicit includeTeams: true flag • includeTeams: true fetches both users and teams, do not use this to fetch a specific user's teams rather fetch that user by id and you will get their team memberships. • name parameter is for USER search ONLY - it cannot be used to search for teams. Use teamIds to fetch specific teams.

Parameters

Optional
getMeboolean

[TOP PRIORITY] Use ALWAYS when requesting current user information. Examples of when it should be used: ["get my user" or "get my teams"]. This parameter CONFLICTS with all others.

includeTeamMembersboolean

Set to true only when you need additional member details for teams other than names and ids.

includeTeamsboolean

[AVOID] This fetches all teams in the account. To fetch a specific user's teams just fetch that user by id and you will get their team memberships.

namestring

Name-based USER search ONLY. STANDALONE parameter - cannot be combined with others. PREFERRED method for finding users when you know names. Performs fuzzy matching. CRITICAL: This parameter searches for USERS ONLY, NOT teams. To search for teams, use teamIds parameter instead.

teamIdsarray

Specific team IDs to fetch.[IMPORTANT] ALWAYS use when you have team IDs in context, NEVER fetch all teams if specific IDs are available. RETURNS: Team details with owners and optional member data.

teamsOnlyboolean

Fetch only teams, no users returned. Combine with includeTeamMembers for member details.

userIdsarray

Specific user IDs to fetch.[IMPORTANT] ALWAYS use when you have user IDs in context. PREFER over general search. RETURNS: user profiles including team memberships

List Workspaces

list_workspaces
Full Description

List all workspaces available to the user. Returns up to 500 workspaces with their ID, name, and description.

Parameters

Optional
limitnumber

The number of workspaces to return. Default and maximum allowed is 100

Default: 100
pagenumber

The page number to return. Default is 1.

Default: 1
searchTermstring

The search term to filter the workspaces by. If not provided, all workspaces will be returned. [IMPORANT] Only alphanumeric characters are supported.

Move Object

move_object
Full Description

Move a folder, board, or overview in monday.com. Use position for relative placement based on another object, parentFolderId for folder changes, workspaceId for workspace moves, and accountProductId for account product changes.

Parameters

Required
idstring

The ID of the object to move

objectTypestring

The type of object to move

Options:BoardFolderOverview
Optional
accountProductIdstring

The ID of the account product containing the object. Required if moving to a different account product.

parentFolderIdstring

The ID of the new parent folder. Required if moving to a different folder.

position_is_afterboolean

Whether to position the object after the object

position_object_idstring

The ID of the object to position the object relative to. If this parameter is provided, position_object_type must be also provided.

position_object_typestring

The type of object to position the object relative to. If this parameter is provided, position_object_id must be also provided.

Options:BoardFolderOverview
workspaceIdstring

The ID of the workspace containing the object. Required if moving to a different workspace.

Read Docs

read_docs
Full Description

Get a collection of monday.com documents with their content as markdown.

PAGINATION:

  • Default limit is 25 documents per page
  • Use 'page' parameter to get additional pages (starts at 1)
  • Check response for 'has_more_pages' to know if you should continue paginating
  • If user asks for "all documents" and you get exactly 25 results, continue with page 2, 3, etc.

FILTERING: Provide a type value and array of ids:

  • type: 'ids' for specific document IDs
  • type: 'object_ids' for specific document object IDs
  • type: 'workspace_ids' for all docs in specific workspaces
  • ids: array of ID strings (at least 1 required)

Examples:

  • { type: 'ids', ids: ['123', '456'] }
  • { type: 'object_ids', ids: ['123'] }
  • { type: 'workspace_ids', ids: ['ws_101'] }

USAGE PATTERNS:

  • For specific documents: use type 'ids' or 'object_ids' (A monday doc has two unique identifiers)
  • For workspace exploration: use type 'workspace_ids' with pagination
  • For large searches: start with page 1, then paginate if has_more_pages=true

Parameters

Required
idsarray

Array of ID values for this query type (at least 1 required)

typestring

Query type of ids parameter that is used query by: ids, object_ids, or workspace_ids

Options:idsobject_idsworkspace_ids
Optional
limitnumber

Number of docs per page (default: 25). Affects pagination - if you get exactly this many results, there may be more pages.

order_bystring

The order in which to retrieve your docs. The default shows created_at with the newest docs listed first. This argument will not be applied if you query docs by specific ids.

Options:created_atused_at
pagenumber

The page number to return (starts at 1). Use this to paginate through large result sets. Check response for has_more_pages indicator.

Search

search
Full Description

Search within monday.com platform. Can search for boards, documents, forms, folders. For users and teams, use list_users_and_teams tool. For workspaces, use list_workspaces tool. For items and groups, use get_board_items_page tool. For groups, use get_board_info tool. IMPORTANT: ids returned by this tool are prefixed with the type of the object (e.g doc-123, board-456, folder-789). When passing the ids to other tools, you need to remove the prefix and just pass the number.

Parameters

Required
searchTypestring

The type of search to perform.

Options:BOARDDOCUMENTSFOLDERS
Optional
limitnumber

The number of items to get. The max and default value is 100.

Default: 100
pagenumber

The page number to get. The default value is 1.

Default: 1
searchTermstring

The search term to use for the search.

workspaceIdsarray

The ids of the workspaces to search in. [IMPORTANT] Only pass this param if user explicitly asked to search within specific workspaces.

Update Folder

update_folder
Full Description

Update an existing folder in monday.com

Parameters

Required
folderIdstring

The ID of the folder to update

Optional
accountProductIdstring

The account product ID associated with the folder

colorstring

The new color of the folder

Options:AQUAMARINEBRIGHT_BLUEBRIGHT_GREENCHILI_BLUEDARK_ORANGEDARK_PURPLEDARK_REDDONE_GREENINDIGOLIPSTICKNULLPURPLESOFIA_PINKSTUCK_REDSUNSETWORKING_ORANGE
customIconstring

The new custom icon of the folder

Options:FOLDERMOREBELOWMOREBELOWFILLEDNULLWORK
fontWeightstring

The new font weight of the folder

Options:FONT_WEIGHT_BOLDFONT_WEIGHT_LIGHTFONT_WEIGHT_NORMALFONT_WEIGHT_VERY_LIGHTNULL
namestring

The new name of the folder

parentFolderIdstring

The ID of the new parent folder

position_is_afterboolean

Whether to position the folder after the object

position_object_idstring

The ID of the object to position the folder relative to. If this parameter is provided, position_object_type must be also provided.

position_object_typestring

The type of object to position the folder relative to. If this parameter is provided, position_object_id must be also provided.

Options:BoardFolderOverview
workspaceIdstring

The ID of the workspace containing the folder

Update Form

update_form
Full Description

Update a monday.com form. Handles the following form update actions that can only be done one at a time using the correct "action" input:

  • update form's feature settings with the action "updateFeatures",
  • update form's appearance settings with the action "updateAppearance",
  • update form's accessibility settings with the action "updateAccessibility",
  • update form's title with the action "updateFormHeader",
  • update form's description with the action "updateFormHeader",
  • update form's question order with the action "updateQuestionOrder",
  • create a new form tag with the action "createTag",
  • delete a form tag with the action "deleteTag",
  • update a form tag with the action "updateTag",
  • set or update the form's password with the action "setFormPassword"
  • shorten form's url with the action "shortenFormUrl"
  • deactivate form with the action "deactivateForm"
  • reactivate form with the action "activateForm"

Parameters

Required
actionstring

The type of update action to perform on the form. Can be one of the following: activate, deactivate, shortenFormUrl, setFormPassword, createTag, deleteTag, updateTag, updateForm, updateAppearance, updateAccessibility, updateFeatures, updateQuestionOrder, updateFormHeader.

Options:activatedeactivateshortenFormUrlsetFormPasswordcreateTagdeleteTagupdateTagupdateAppearanceupdateAccessibilityupdateFeaturesupdateQuestionOrderupdateFormHeader
formTokenstring

The unique identifier token for the form. Required for all form-specific operations.

Optional
formobject

The form data to update. Required if updating the appearance, accessibility, features, question order, or form header.

formPasswordstring

Set a password on a form to restrict access. This will enable password protection for the form. Required for the action "setFormPassword" in the update form tool.

formStringifiedstring

**ONLY FOR MICROSOFT COPILOT**: The form data. Send this as a stringified JSON of "form" field. Read "form" field description for details how to use it.

tagobject

The tag data to create, update or delete. If deleting a tag, only provide the id of the tag to delete. If creating a tag, provide the name and value, the id and columnId are auto generated. If updating a tag, provide the id and new value, name and columnId are not changeable.

tagStringifiedstring

**ONLY FOR MICROSOFT COPILOT**: The tag data. Send this as a stringified JSON of "tag" field. Read "tag" field description for details how to use it.

Update Workspace

update_workspace
Full Description

Update an existing workspace in monday.com

Parameters

Required
idstring

The ID of the workspace to update

Optional
attributeAccountProductIdnumber

The target account product's ID to move the workspace to

attributeDescriptionstring

The description of the workspace to update

attributeKindstring

The kind of the workspace to update (open / closed / template)

Options:closedopentemplate
attributeNamestring

The name of the workspace to update

Workspace Info

workspace_info
Full Description

This tool returns the boards, docs and folders in a workspace and which folder they are in. It returns up to 100 of each object type, if you receive 100 assume there are additional objects of that type in the workspace.

Parameters

Required
workspace_idnumber

The ID of the workspace to get information for

Links

WebsitePrivacy PolicyTerms of Service