Monday MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Set up the connector

   Register your Monday MCP credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

   Dashboard setup steps

   Monday MCP uses Dynamic Client Registration (DCR) with PKCE — no client ID or secret is needed. Scalekit registers the OAuth client automatically the first time a user authorizes the connection, so creating the connection in Scalekit is the only setup step.

   1. Create the Monday MCP connection in Scalekit

      In the Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Monday MCP and click Create.

      No OAuth app or credentials required

      Because Monday MCP supports DCR, you do not register an app in the monday.com Developer Center or paste a client ID and secret. Scalekit negotiates the OAuth client with the Monday MCP server at https://mcp.monday.com/mcp automatically.

   2. Have your user authorize the connection

      Send the user through the connection’s authorization link (the magic link Scalekit generates, or the link returned by the SDK). The user signs in to monday.com and grants access.

      On first authorization, Scalekit completes Dynamic Client Registration and PKCE behind the scenes, then stores and refreshes tokens for every user who connects — no further configuration is needed.

4. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'mondaymcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Monday MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'mondaymcp_search',
     toolInput: { searchType: 'YOUR_SEARCHTYPE' },
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "mondaymcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Monday MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={"searchType":"YOUR_SEARCHTYPE"},
       tool_name="mondaymcp_search",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Agentcatalog records — Browse the account-wide catalog of available trigger types and skills for monday platform agents
• Allmondayapi records — Execute any monday.com API operation by generating GraphQL queries and mutations dynamically
• Allwidgetsschema records — Fetch complete JSON Schema 7 definitions for all available widget types in monday.com
• Boardinsights records — This tool allows you to calculate insights about board’s data by filtering, grouping and aggregating columns
• Changeitemcolumnvalues records — Change the column values of an item in a monday.com board
• Createautomation records — Creates an automation on a monday board from a structured natural-language description

Common workflows

Get items from a board

Use mondaymcp_get_board_items_page to fetch items from a monday.com board. You need the board’s numeric ID, which you can find in the board URL (https://mycompany.monday.com/boards/<BOARD_ID>).

Find your board ID

Open the board in monday.com and look at the URL. The number after /boards/ is the board ID. You can also call mondaymcp_get_board_info with a search term to discover board IDs programmatically.

Node.js

const items = await actions.executeTool({
  connectionName: 'mondaymcp',
  identifier: 'user_123',
  toolName: 'mondaymcp_get_board_items_page',
  toolInput: {
    boardId: '1234567890',
    limit: 50,
  },
});
console.log(items);

Python

items = actions.execute_tool(
    connection_name="mondaymcp",
    identifier="user_123",
    tool_name="mondaymcp_get_board_items_page",
    tool_input={
        "boardId": "1234567890",
        "limit": 50,
    },
)
print(items)

Create an item and add an update

Use mondaymcp_create_item to add a new item to a board, then mondaymcp_create_update to post a comment or status update on it.

Node.js

// Step 1 — create the item
const newItem = await actions.executeTool({
  connectionName: 'mondaymcp',
  identifier: 'user_123',
  toolName: 'mondaymcp_create_item',
  toolInput: {
    boardId: '1234567890',
    itemName: 'Fix login bug',
    groupId: 'topics',
  },
});
const itemId = newItem.id;

// Step 2 — post an update on the item
await actions.executeTool({
  connectionName: 'mondaymcp',
  identifier: 'user_123',
  toolName: 'mondaymcp_create_update',
  toolInput: {
    itemId,
    body: 'Assigned to the auth team. Expected fix in next sprint.',
  },
});

Python

# Step 1 — create the item
new_item = actions.execute_tool(
    connection_name="mondaymcp",
    identifier="user_123",
    tool_name="mondaymcp_create_item",
    tool_input={
        "boardId": "1234567890",
        "itemName": "Fix login bug",
        "groupId": "topics",
    },
)
item_id = new_item["id"]

# Step 2 — post an update on the item
actions.execute_tool(
    connection_name="mondaymcp",
    identifier="user_123",
    tool_name="mondaymcp_create_update",
    tool_input={
        "itemId": item_id,
        "body": "Assigned to the auth team. Expected fix in next sprint.",
    },
)

Update column values on an item

Use mondaymcp_change_item_column_values to set structured column data — such as status, date, or assignee — on an existing item.

Node.js

await actions.executeTool({
  connectionName: 'mondaymcp',
  identifier: 'user_123',
  toolName: 'mondaymcp_change_item_column_values',
  toolInput: {
    boardId: '1234567890',
    itemId: '9876543210',
    // Column values are JSON-encoded per the monday.com column type
    columnValues: JSON.stringify({
      status: { label: 'In Progress' },
      date4: { date: '2025-08-01' },
    }),
  },
});

Python

import json

actions.execute_tool(
    connection_name="mondaymcp",
    identifier="user_123",
    tool_name="mondaymcp_change_item_column_values",
    tool_input={
        "boardId": "1234567890",
        "itemId": "9876543210",
        # Column values are JSON-encoded per the monday.com column type
        "columnValues": json.dumps({
            "status": {"label": "In Progress"},
            "date4": {"date": "2025-08-01"},
        }),
    },
)

Search across monday.com

Use mondaymcp_search to find items, boards, docs, or users by keyword.

Node.js

const results = await actions.executeTool({
  connectionName: 'mondaymcp',
  identifier: 'user_123',
  toolName: 'mondaymcp_search',
  toolInput: {
    query: 'Q3 roadmap',
    searchType: 'boards',
  },
});
console.log(results);

Python

results = actions.execute_tool(
    connection_name="mondaymcp",
    identifier="user_123",
    tool_name="mondaymcp_search",
    tool_input={
        "query": "Q3 roadmap",
        "searchType": "boards",
    },
)
print(results)

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

mondaymcp_agentcatalog#Browse the account-wide catalog of available trigger types and skills for monday platform agents. READ-ONLY — no agent_id required. Use this tool to discover what's available BEFORE wiring anything to a specific agent. ACTIONS: - list_triggers: { block_reference_ids? } — returns available trigger types. Each entry has block_reference_id (required for manage_agent_triggers action:"add"), name, description, field_schemas (describes field_values shape), and required_fields (fields to collect from the user). Note: only triggers that can be added programmatically appear here. OAuth/3rd-party triggers (Slack, Gmail, Salesforce, etc.) require user setup in the monday.com UI and will not appear here. - list_skills: {} — returns available skills with id, name, description. Never guess or invent a skill id — always look it up here before calling manage_agent_skills action:"add". USAGE EXAMPLES: - List all trigger types: { "action": "list_triggers" } - Fetch specific trigger: { "action": "list_triggers", "block_reference_ids": ["some-block-ref-id"] } - List all skills: { "action": "list_skills" } RELATED TOOLS: - manage_agent_triggers — use block_reference_id from list_triggers to attach a trigger to a specific agent - manage_agent_skills — use skill id from list_skills, or action:"create" to author a new skill, then attach to an agent - manage_agent — manage the agent entity itself (create, update, delete, activate, etc.)2 params▾

Browse the account-wide catalog of available trigger types and skills for monday platform agents. READ-ONLY — no agent_id required. Use this tool to discover what's available BEFORE wiring anything to a specific agent. ACTIONS: - list_triggers: { block_reference_ids? } — returns available trigger types. Each entry has block_reference_id (required for manage_agent_triggers action:"add"), name, description, field_schemas (describes field_values shape), and required_fields (fields to collect from the user). Note: only triggers that can be added programmatically appear here. OAuth/3rd-party triggers (Slack, Gmail, Salesforce, etc.) require user setup in the monday.com UI and will not appear here. - list_skills: {} — returns available skills with id, name, description. Never guess or invent a skill id — always look it up here before calling manage_agent_skills action:"add". USAGE EXAMPLES: - List all trigger types: { "action": "list_triggers" } - Fetch specific trigger: { "action": "list_triggers", "block_reference_ids": ["some-block-ref-id"] } - List all skills: { "action": "list_skills" } RELATED TOOLS: - manage_agent_triggers — use block_reference_id from list_triggers to attach a trigger to a specific agent - manage_agent_skills — use skill id from list_skills, or action:"create" to author a new skill, then attach to an agent - manage_agent — manage the agent entity itself (create, update, delete, activate, etc.)

NameTypeRequiredDescription

actionstringrequired"list_triggers" — fetch available trigger types with block_reference_id, field_schemas, and required_fields. Call before using manage_agent_triggers action:"add". "list_skills" — fetch available skills with id, name, description. Call before using manage_agent_skills action:"add".

block_reference_idsarrayoptionalUsed with action:"list_triggers". Fetch specific trigger types by block_reference_id. Omit to return all trigger types.

mondaymcp_allmondayapi#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.2 params▾

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.

NameTypeRequiredDescription

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

variablesstringrequiredJSON string containing the variables for the GraphQL operation

mondaymcp_allwidgetsschema#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.0 params▾

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.

mondaymcp_boardinsights#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.7 params▾

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.

NameTypeRequiredDescription

boardIdnumberrequiredThe id of the board to get insights for

aggregationsarrayoptionalThe aggregations to get. Before sending the aggregations, read guidelines.aggregation from get_column_type_info with fetchMode "guidelines" for a relevant column type on this board. Transformative functions and plain columns (no function) must be in group by.

filtersarrayoptionalThe configuration of filters to apply on the items. Use get_board_info for column ids and types on the board. Before sending the filters, use get_column_type_info with fetchMode "guidelines" and use data.guidelines.filter (null if that type has no documented rules).

filtersOperatorstringoptionalThe operator to use for the filters

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

limitnumberoptionalThe limit of the results

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

mondaymcp_changeitemcolumnvalues#Change the column values of an item in a monday.com board. [REQUIRED PRECONDITION]: For board-relation linking tasks, call link_board_items_workflow before using this tool.4 params▾

Change the column values of an item in a monday.com board. [REQUIRED PRECONDITION]: For board-relation linking tasks, call link_board_items_workflow before using this tool.

NameTypeRequiredDescription

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

columnValuesstringrequiredA 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\"}"

itemIdnumberrequiredThe ID of the item to be updated

createLabelsIfMissingbooleanoptionalIf true, create missing Status/Dropdown labels when setting those columns. Requires permission to change board structure. Omit or false to only use existing labels.

mondaymcp_createautomation# Creates an automation on a monday board from a structured natural-language description. Use this tool only when you know: - boardId - the user's intended trigger - at least one intended action - any details the user provided that are relevant to the trigger, conditions, or actions The caller does not need to know the exact available automation blocks or their required fields. Describe the user's intent clearly — the tool will translate that intent into supported blocks and values. If a required detail is missing from the user's request, ask for clarification before calling the tool. If the tool returns status: "needs_clarification", present the unresolved fields to the user, gather answers, then call the tool again. Describe the automation in this format: Trigger: When <the event that should start the automation> Details: <relevant detail>: <value> Conditions: - Only if <condition that should be true> Details: <relevant detail>: <value> Actions: - <action the automation should perform>: <relevant detail>: <value> Rules: - Use one trigger. - Conditions are optional. - Multiple conditions mean AND. - Use one or more actions. - Do not use branching. - Use natural language, not block IDs or internal field names. - Actions may reference values from the trigger context, such as "{{item name}}", "{{creator}}", "{{status}}", "{{group}}", or "{{board}}". Terminology: - Trigger: the event that starts the automation, such as "when a new item is created". - Conditions: optional requirements that must be true before actions run. - Actions: what the automation does when it runs. Example: Trigger: When a new item is created Actions: - Send a notification: Recipient: John Snow Title: Important Update Message: The item "{{item name}}" was created. - Move the item to a group: Group: Top group 2 params▾

Creates an automation on a monday board from a structured natural-language description. Use this tool only when you know: - boardId - the user's intended trigger - at least one intended action - any details the user provided that are relevant to the trigger, conditions, or actions The caller does not need to know the exact available automation blocks or their required fields. Describe the user's intent clearly — the tool will translate that intent into supported blocks and values. If a required detail is missing from the user's request, ask for clarification before calling the tool. If the tool returns status: "needs_clarification", present the unresolved fields to the user, gather answers, then call the tool again. Describe the automation in this format: Trigger: When <the event that should start the automation> Details: <relevant detail>: <value> Conditions: - Only if <condition that should be true> Details: <relevant detail>: <value> Actions: - <action the automation should perform>: <relevant detail>: <value> Rules: - Use one trigger. - Conditions are optional. - Multiple conditions mean AND. - Use one or more actions. - Do not use branching. - Use natural language, not block IDs or internal field names. - Actions may reference values from the trigger context, such as "{{item name}}", "{{creator}}", "{{status}}", "{{group}}", or "{{board}}". Terminology: - Trigger: the event that starts the automation, such as "when a new item is created". - Conditions: optional requirements that must be true before actions run. - Actions: what the automation does when it runs. Example: Trigger: When a new item is created Actions: - Send a notification: Recipient: John Snow Title: Important Update Message: The item "{{item name}}" was created. - Move the item to a group: Group: Top group

NameTypeRequiredDescription

boardIdstringrequiredThe numeric board ID as a string.

userPromptstringrequiredStructured description of the automation to create.

mondaymcp_createboard#Create a monday.com board5 params▾

Create a monday.com board

NameTypeRequiredDescription

boardNamestringrequiredThe name of the board to create

boardDescriptionstringoptionalThe description of the board to create

boardKindstringoptionalThe kind of board to create

boardOwnerIdsarrayoptionalOptional list of user IDs to set as board owners

workspaceIdstringoptionalThe ID of the workspace to create the board in

mondaymcp_createcolumn#Create a new column in a monday.com board5 params▾

Create a new column in a monday.com board

NameTypeRequiredDescription

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

columnTitlestringrequiredThe title of the column to be created

columnTypestringrequiredThe type of the column to be created

columnDescriptionstringoptionalThe description of the column to be created

columnSettingsstringoptionalColumn-specific configuration settings as a JSON string. Use get_column_type_info with fetchMode "schema" for the JSON schema for the given column type.

mondaymcp_createdashboard#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 widgets5 params▾

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

NameTypeRequiredDescription

board_idsarrayrequiredList of board IDs as strings (min 1 element)

namestringrequiredHuman-readable dashboard title (UTF-8 chars)

workspace_idstringrequiredID of the workspace that will own the dashboard

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

kindstringoptionalVisibility level: PUBLIC or PRIVATE

mondaymcp_createdoc#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, optional docOwnerIds) - item: Creates a document attached to an item (requires item_id, optional column_id, optional docOwnerIds) USAGE EXAMPLES: - Workspace doc: { location: "workspace", workspace_id: 123, doc_name: "My Doc", doc_kind: "private" , markdown: "..." } - Workspace doc in folder: { location: "workspace", workspace_id: 123, doc_name: "My Doc", folder_id: 17264196 , markdown: "..." } - Item doc: { location: "item", item_id: 456, doc_name: "My Doc", column_id: "doc_col_1" , markdown: "..." } - Workspace doc with agent owner: { location: "workspace", workspace_id: 123, doc_name: "My Doc", markdown: "...", docOwnerIds: ["<agent_owner_user_id>"] }9 params▾

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, optional docOwnerIds) - item: Creates a document attached to an item (requires item_id, optional column_id, optional docOwnerIds) USAGE EXAMPLES: - Workspace doc: { location: "workspace", workspace_id: 123, doc_name: "My Doc", doc_kind: "private" , markdown: "..." } - Workspace doc in folder: { location: "workspace", workspace_id: 123, doc_name: "My Doc", folder_id: 17264196 , markdown: "..." } - Item doc: { location: "item", item_id: 456, doc_name: "My Doc", column_id: "doc_col_1" , markdown: "..." } - Workspace doc with agent owner: { location: "workspace", workspace_id: 123, doc_name: "My Doc", markdown: "...", docOwnerIds: ["<agent_owner_user_id>"] }

NameTypeRequiredDescription

doc_namestringrequiredName for the new document.

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

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

column_idstringoptional[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_kindstringoptional[OPTIONAL - use only when location="workspace"] Document kind (public/private/share). Defaults to public.

docOwnerIdsarrayoptionalOptional list of user IDs to set as document owners at creation time. Use this to add the agent owner so they retain access to the document. Ownership is set inside the creation mutation itself, bypassing the permission checks that would block a subsequent add_subscribers_to_object call.

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

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

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

mondaymcp_createfolder#Create a new folder in a monday.com workspace6 params▾

Create a new folder in a monday.com workspace

NameTypeRequiredDescription

namestringrequiredThe name of the folder to be created

workspaceIdstringrequiredThe ID of the workspace where the folder will be created

colorstringoptionalThe color of the folder

customIconstringoptionalThe custom icon of the folder

fontWeightstringoptionalThe font weight of the folder

parentFolderIdstringoptionalThe ID of the parent folder

mondaymcp_createform#Create a monday.com form. Also creates a backing board to store responses. Returns the formToken for future mutations.9 params▾

Create a monday.com form. Also creates a backing board to store responses. Returns the formToken for future mutations.

NameTypeRequiredDescription

destination_workspace_idstringrequiredNo description.

board_kindstringoptionalNo description.

board_owner_idsarrayoptionalNo description.

board_owner_team_idsarrayoptionalNo description.

board_subscriber_idsarrayoptionalUser IDs to notify on board activity.

board_subscriber_teams_idsarrayoptionalTeam IDs to notify on board activity.

destination_folder_idstringoptionalNo description.

destination_folder_namestringoptionalNo description.

destination_namestringoptionalBoard name (stores form responses).

mondaymcp_createformsubmission#Submit a response to a monday.com WorkForm. Use get_form first to retrieve the WorkForm, then: - Inspect each question's showIfRules to determine which questions are conditionally shown based on previous answers. - Inspect each question's settings for any answer constraints (e.g. rating limits, select options, label limits). - Take note of any titles, descriptions, and content blocks to present the form naturally as you walk the user through it. - Take note of pages and question order to present questions in the correct sequence. Gather all answers upfront before calling this tool — do not submit one question at a time. Accepts a bare form token, a full WorkForm URL (e.g. https://forms.monday.com/forms/{form_token}?r=use1), or a shortened wkf.ms URL (e.g. https://wkf.ms/4tqP28t) — shortened URLs are automatically resolved by following the redirect. Returns the submission ID.5 params▾

Submit a response to a monday.com WorkForm. Use get_form first to retrieve the WorkForm, then: - Inspect each question's showIfRules to determine which questions are conditionally shown based on previous answers. - Inspect each question's settings for any answer constraints (e.g. rating limits, select options, label limits). - Take note of any titles, descriptions, and content blocks to present the form naturally as you walk the user through it. - Take note of pages and question order to present questions in the correct sequence. Gather all answers upfront before calling this tool — do not submit one question at a time. Accepts a bare form token, a full WorkForm URL (e.g. https://forms.monday.com/forms/{form_token}?r=use1), or a shortened wkf.ms URL (e.g. https://wkf.ms/4tqP28t) — shortened URLs are automatically resolved by following the redirect. Returns the submission ID.

NameTypeRequiredDescription

answersarrayrequiredArray of answers to submit. Each answer specifies a question_id and the value for that question type.

form_timezone_offsetintegerrequiredThe timezone offset of the submitter in minutes (e.g. -120 for UTC-2, 0 for UTC).

form_tokenstringrequiredThe unique token identifying the WorkForm. Can be a bare token, a full WorkForm URL (e.g. https://forms.monday.com/forms/abc123?r=use1), or a shortened wkf.ms URL (e.g. https://wkf.ms/4tqP28t). Shortened URLs are automatically resolved by following the redirect.

passwordstringoptionalThe password for the WorkForm. Only required if the WorkForm has password protection enabled (check features.password.enabled from get_form). If required, ask the user for the password before submitting.

tagsarrayoptionalTags to attach to the submission — each tag maps a value to a specific board column.

mondaymcp_creategroup#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 creation5 params▾

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

NameTypeRequiredDescription

boardIdstringrequiredThe ID of the board to create the group in

groupNamestringrequiredThe name of the new group (maximum 255 characters)

groupColorstringoptionalThe 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

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

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

mondaymcp_createitem#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.6 params▾

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.

NameTypeRequiredDescription

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

columnValuesstringrequiredA 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\"}"

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

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

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

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

mondaymcp_createnotification#Send a notification to a user via the bell icon and optionally by email. Use target_type "Post" for updates/replies or "Project" for items/boards.4 params▾

Send a notification to a user via the bell icon and optionally by email. Use target_type "Post" for updates/replies or "Project" for items/boards.

NameTypeRequiredDescription

target_idstringrequiredThe target ID (update/reply ID for Post type, item/board ID for Project type)

target_typestringrequiredThe target type (Post for update/reply, Project for item/board)

textstringrequiredThe notification text

user_idstringrequiredThe user ID to send the notification to

mondaymcp_createupdate#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. You can also reply to an existing update by using the parentId parameter.4 params▾

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. You can also reply to an existing update by using the parentId parameter.

NameTypeRequiredDescription

bodystringrequiredThe update text to be created. Do not use @ to mention users, use the mentionsList field instead. use html tags to format the text, dont use markdown.

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

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

parentIdnumberoptionalThe ID of the update to reply to. Use this parameter when you want to reply on an existing update leave it empty if you want to create a new update

mondaymcp_createview#Create a new board view (tab) with optional filters and sorting. This creates a saved view on a monday.com board that users can switch to. Filter operators: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text Example filter for people column: { "rules": [{ "column_id": "people", "compare_value": ["person-12345"], "operator": "any_of" }] } Example filter for status column: { "rules": [{ "column_id": "status", "compare_value": [1], "operator": "any_of" }] }6 params▾

Create a new board view (tab) with optional filters and sorting. This creates a saved view on a monday.com board that users can switch to. Filter operators: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text Example filter for people column: { "rules": [{ "column_id": "people", "compare_value": ["person-12345"], "operator": "any_of" }] } Example filter for status column: { "rules": [{ "column_id": "status", "compare_value": [1], "operator": "any_of" }] }

NameTypeRequiredDescription

boardIdstringrequiredThe board ID to create the view on

filterobjectoptionalFilter configuration for the view

namestringoptionalThe name of the view (e.g. "High Priority Items", "My Tasks")

settingsstringoptionalType-specific view settings as a JSON object (e.g. column visibility, group_by for TABLE). The shape varies by view type — call get_view_schema_by_type with the same ViewKind to discover the supported structure. For TABLE views, prefer the dedicated create_view_table tool which exposes a strongly-typed settings field.

sortarrayoptionalSort configuration for the view

typestringoptionalThe type of board view to create. Use TABLE for standard board views.

mondaymcp_createviewtable#Create a new table-type board view with optional filters, sort, tags, and table-specific settings (column visibility/order and group-by). Use this instead of create_view when you need to configure table-specific settings. For a simple table view, create_view also works. Filter operators: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text Example settings.columns: { "column_properties": [{ "column_id": "status", "visible": true }], "column_order": ["name", "status", "date"] } Example settings.group_by: { "conditions": [{ "columnId": "status" }], "hideEmptyGroups": true }6 params▾

Create a new table-type board view with optional filters, sort, tags, and table-specific settings (column visibility/order and group-by). Use this instead of create_view when you need to configure table-specific settings. For a simple table view, create_view also works. Filter operators: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text Example settings.columns: { "column_properties": [{ "column_id": "status", "visible": true }], "column_order": ["name", "status", "date"] } Example settings.group_by: { "conditions": [{ "columnId": "status" }], "hideEmptyGroups": true }

NameTypeRequiredDescription

boardIdstringrequiredThe board ID to create the table view on

filterobjectoptionalFilter configuration for the view

namestringoptionalThe name of the view (e.g. "High Priority Items", "My Tasks")

settingsobjectoptionalTable-specific view settings (column visibility/order, group-by)

sortarrayoptionalSort configuration for the view

tagsarrayoptionalTags to apply to the view

mondaymcp_createwidget#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 widget5 params▾

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

NameTypeRequiredDescription

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

parent_container_typestringrequiredType of parent container: DASHBOARD or BOARD_VIEW

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

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

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

mondaymcp_createworkflow#Creates a new empty workflow in a monday.com workspace. Use this when the user wants to build a new standalone workflow from scratch. Workflows are cross-board, workspace-level — distinct from automations (use create_automation for those). You only need a workspaceId to get started — all other fields are optional. Returns: - workflowObjectId: the workflow object ID - workflowDraftId: the current draft version ID — workflows start as drafts and must be published before they run Terminology: - Workflows vs. automations: workflows are standalone objects scoped to a workspace. Automations (create_automation) are per-board trigger/action rules. They are different products. - Draft: the editable, inactive version of a workflow. Changes are made on the draft version until it is published as the live version. - Privacy: PUBLIC — visible to all workspace members (default). PRIVATE — restricted access. SHAREABLE — accessible to guests outside the account. Note: if directing the user to the workflow in the UI, the correct URL path is custom_objects/, not workflows/ — e.g. {account}.monday.com/custom_objects/{workflowObjectId}. 6 params▾

Creates a new empty workflow in a monday.com workspace. Use this when the user wants to build a new standalone workflow from scratch. Workflows are cross-board, workspace-level — distinct from automations (use create_automation for those). You only need a workspaceId to get started — all other fields are optional. Returns: - workflowObjectId: the workflow object ID - workflowDraftId: the current draft version ID — workflows start as drafts and must be published before they run Terminology: - Workflows vs. automations: workflows are standalone objects scoped to a workspace. Automations (create_automation) are per-board trigger/action rules. They are different products. - Draft: the editable, inactive version of a workflow. Changes are made on the draft version until it is published as the live version. - Privacy: PUBLIC — visible to all workspace members (default). PRIVATE — restricted access. SHAREABLE — accessible to guests outside the account. Note: if directing the user to the workflow in the UI, the correct URL path is custom_objects/, not workflows/ — e.g. {account}.monday.com/custom_objects/{workflowObjectId}.

NameTypeRequiredDescription

workspaceIdstringrequiredThe ID of the workspace to create the workflow in.

descriptionstringoptionalOptional workflow description.

folderIdstringoptionalOptional folder ID to place the workflow in.

ownerIdsarrayoptionalOptional list of user IDs to set as workflow owners.

privacyKindstringoptionalWorkflow visibility: PUBLIC (default), PRIVATE, or SHAREABLE (accessible to guests outside the account).

titlestringoptionalWorkflow title. Defaults to "New Workflow" if not provided.

mondaymcp_createworkspace#Create a new workspace in monday.com4 params▾

Create a new workspace in monday.com

NameTypeRequiredDescription

namestringrequiredThe name of the new workspace to be created

workspaceKindstringrequiredThe kind of workspace to create

accountProductIdstringoptionalThe account product ID associated with the workspace

descriptionstringoptionalThe description of the new workspace

mondaymcp_finalizeassetupload#Finalize a file upload and create the asset on monday.com. Call this after uploading the file to the presigned URL from get_asset_upload_url. Requires the etag value from the PUT response headers. Automatically attaches the uploaded asset to the specified file column on the item. Returns the created asset_id.5 params▾

Finalize a file upload and create the asset on monday.com. Call this after uploading the file to the presigned URL from get_asset_upload_url. Requires the etag value from the PUT response headers. Automatically attaches the uploaded asset to the specified file column on the item. Returns the created asset_id.

NameTypeRequiredDescription

boardIdstringrequiredThe board's unique identifier

columnIdstringrequiredThe file or doc column's unique identifier to attach the uploaded asset to

etagstringrequiredThe ETag header value from the PUT response when uploading to the presigned URL

itemIdstringrequiredThe item's unique identifier

uploadIdstringrequiredThe upload_id returned by get_asset_upload_url

mondaymcp_formquestionseditor#Create, update, or delete a question in a monday.com form4 params▾

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

NameTypeRequiredDescription

actionstringrequiredAction to perform on the question of a form. create requires question. update requires questionId and question with type always included. delete requires questionId.

formTokenstringrequiredNo description.

questionobjectoptionalThe question to create or update. Always include type, then only the fields you want to set or change.

questionIdstringoptionalQuestion ID. Required for update/delete.

mondaymcp_getassets#Get assets (files) by their IDs. Returns file metadata including name, extension, size, public URL (valid for 1 hour), thumbnail URL, upload date, and who uploaded it.1 param▾

Get assets (files) by their IDs. Returns file metadata including name, extension, size, public URL (valid for 1 hour), thumbnail URL, upload date, and who uploaded it.

NameTypeRequiredDescription

idsarrayrequiredArray of asset IDs to fetch

mondaymcp_getassetuploadurl#Get a presigned URL to upload a file to monday.com. Returns an upload_id and upload_url. After calling this tool, upload the file to the returned URL using an HTTP PUT request and capture the ETag header from the response: curl -i -X PUT "<upload_url>" \ -H "Content-Type: <the contentType you provided>" \ --data-binary @<local_file_path> The response includes an ETag header (e.g. ETag: "abc123...") — save this value. Then call finalize_asset_upload with the upload_id, etag, board_id, item_id, and column_id to complete the upload and attach the file to an item's file column. Max file size: 500MB.3 params▾

Get a presigned URL to upload a file to monday.com. Returns an upload_id and upload_url. After calling this tool, upload the file to the returned URL using an HTTP PUT request and capture the ETag header from the response: curl -i -X PUT "<upload_url>" \ -H "Content-Type: <the contentType you provided>" \ --data-binary @<local_file_path> The response includes an ETag header (e.g. ETag: "abc123...") — save this value. Then call finalize_asset_upload with the upload_id, etag, board_id, item_id, and column_id to complete the upload and attach the file to an item's file column. Max file size: 500MB.

NameTypeRequiredDescription

contentTypestringrequiredThe MIME type of the file (e.g. "application/pdf", "image/png", "text/plain")

fileNamestringrequiredThe name of the file to upload, including extension (e.g. "report.pdf")

fileSizeintegerrequiredThe file size in bytes. Maximum 500MB (524288000 bytes)

mondaymcp_getautomationruns#Read automation/workflow run history. Read-only. Modes: - "history": paginated run feed (state, duration, error reason). Use "filters" to narrow results and "nextPageOffset" to page (offset-only — next page = previous offset + returned count). - "detail": single run by "triggerUuid" (required) — returns block steps and MCP tool calls. Set "includeToolEvents": false to skip tool calls. Scope: provide "boardId" for a specific board or "accountWide": true. One is required. Known event states: "success", "failure", "exhausted".9 params▾

Read automation/workflow run history. Read-only. Modes: - "history": paginated run feed (state, duration, error reason). Use "filters" to narrow results and "nextPageOffset" to page (offset-only — next page = previous offset + returned count). - "detail": single run by "triggerUuid" (required) — returns block steps and MCP tool calls. Set "includeToolEvents": false to skip tool calls. Scope: provide "boardId" for a specific board or "accountWide": true. One is required. Known event states: "success", "failure", "exhausted".

NameTypeRequiredDescription

modestringrequiredhistory = paginated run feed, detail = single run by triggerUuid

accountWidebooleanoptionalSet true to query account-wide (required if no boardId)

blockEventsOffsetintegeroptionaldetail: block-events page offset

boardIdstringoptionalTarget a specific board by numeric ID

filtersobjectoptionalhistory: run filters

includeToolEventsbooleanoptionaldetail: include MCP tool calls (default true)

nextPageOffsetintegeroptionalhistory: page offset (offset-only pagination)

toolEventsOffsetintegeroptionaldetail: tool-events page offset

triggerUuidstringoptionaldetail: required — the run UUID to inspect

mondaymcp_getautomationstatistics#Aggregate automation run statistics. Read-only. Breakdowns: - "totals": success/failure/total counts at the account or board level. - "by_entity": per-automation and per-workflow counts for a given "runStatus" (required: "success" | "failure" | "exhausted"). Use "excludeAutomationIds" to omit specific automations. Scope: provide "boardId" for a specific board or "accountWide": true. One is required. Optional "userIds" narrows results to specific creators.6 params▾

Aggregate automation run statistics. Read-only. Breakdowns: - "totals": success/failure/total counts at the account or board level. - "by_entity": per-automation and per-workflow counts for a given "runStatus" (required: "success" | "failure" | "exhausted"). Use "excludeAutomationIds" to omit specific automations. Scope: provide "boardId" for a specific board or "accountWide": true. One is required. Optional "userIds" narrows results to specific creators.

NameTypeRequiredDescription

breakdownstringrequiredtotals = success/failure/total counts, by_entity = per automation/workflow

accountWidebooleanoptionalSet true to query account-wide (required if no boardId)

boardIdstringoptionalTarget a specific board by numeric ID

excludeAutomationIdsarrayoptionalby_entity: automation IDs to exclude from breakdown

runStatusstringoptionalby_entity: required run status to break down

userIdsarrayoptionalNarrow to specific creator user IDs

mondaymcp_getboardactivity#Get board activity logs for a specified time range (defaults to last 30 days). Optionally filter by item ids or user ids to avoid fetching activity for the entire board.6 params▾

Get board activity logs for a specified time range (defaults to last 30 days). Optionally filter by item ids or user ids to avoid fetching activity for the entire board.

NameTypeRequiredDescription

boardIdnumberrequiredThe id of the board to get activity for

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

includeDatabooleanoptionalWhether to include the raw data payload for each activity entry. The data field contains the full before/after state of changes and can be very large. Only set to true when you need the detailed change data.

itemIdsarrayoptionalFilter activity to specific item ids. Omit to get activity for the whole board.

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

userIdsarrayoptionalFilter activity to actions performed by specific user ids.

mondaymcp_getboardinfo#Get comprehensive board information including metadata, structure, owners, and configuration. Also returns the board's views (e.g. table views, filter views) — each view includes its id, name, type, and a structured filter object. 1 param▾

Get comprehensive board information including metadata, structure, owners, and configuration. Also returns the board's views (e.g. table views, filter views) — each view includes its id, name, type, and a structured filter object.

NameTypeRequiredDescription

boardIdnumberrequiredThe id of the board to get information for

mondaymcp_getboarditemspage#Get all items from a monday.com board with pagination support and optional column values and item descriptions. 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. To retrieve an item description (the rich-text body/details of a monday.com item), set includeItemDescription to true — the response will include the item description document blocks with their content, type, and id. Use this whenever the user asks about an item description, body, details, or notes. [REQUIRED PRECONDITION]: Before using this tool, if new columns were added to the board or if you are not familiar with the board 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. [REQUIRED PRECONDITION]: For board-relation / cross-board linking tasks, call link_board_items_workflow before using this tool. VIEW-BASED FILTERING: If the user refers to a board view by name (e.g. "show me items in the Overdue view"), first call get_board_info to get the board views, find the matching view by name, then extract its filter field and pass it as the filters argument here.13 params▾

Get all items from a monday.com board with pagination support and optional column values and item descriptions. 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. To retrieve an item description (the rich-text body/details of a monday.com item), set includeItemDescription to true — the response will include the item description document blocks with their content, type, and id. Use this whenever the user asks about an item description, body, details, or notes. [REQUIRED PRECONDITION]: Before using this tool, if new columns were added to the board or if you are not familiar with the board 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. [REQUIRED PRECONDITION]: For board-relation / cross-board linking tasks, call link_board_items_workflow before using this tool. VIEW-BASED FILTERING: If the user refers to a board view by name (e.g. "show me items in the Overdue view"), first call get_board_info to get the board views, find the matching view by name, then extract its filter field and pass it as the filters argument here.

NameTypeRequiredDescription

boardIdnumberrequiredThe id of the board to get items from

columnIdsarrayoptionalThe 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

cursorstringoptionalThe 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

filtersarrayoptionalThe configuration of filters to apply on the items. Use get_board_info for column ids and types on the board. Before sending the filters, use get_column_type_info with fetchMode "guidelines" and use data.guidelines.filter (null if that type has no documented rules).

filtersOperatorstringoptionalThe operator to use for the filters

includeColumnsbooleanoptionalWhether 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.

includeItemDescriptionbooleanoptionalWhether to include the item's description in the response. The item description is the rich-text body content that appears inside a monday.com item (similar to a task description or issue body). Set this to true when the user asks about an item's description, details, body, or notes. PERFORMANCE OPTIMIZATION: Only set this to true when you actually need the item description content.

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

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

limitnumberoptionalThe number of items to get

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

searchTermstringoptional 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.

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

mondaymcp_getcolumntypeinfo#Retrieves comprehensive information about a specific column type. Use fetchMode "schema" (default) to get the JSON schema definition from the API — use this before creating or updating columns (e.g. create_column) to understand structure, validation rules, and available properties for column settings. Use fetchMode "guidelines" to get only guidelines.filter and guidelines.aggregation for building items_page filters and board insights counts (no schema, no GraphQL round-trip). 2 params▾

Retrieves comprehensive information about a specific column type. Use fetchMode "schema" (default) to get the JSON schema definition from the API — use this before creating or updating columns (e.g. create_column) to understand structure, validation rules, and available properties for column settings. Use fetchMode "guidelines" to get only guidelines.filter and guidelines.aggregation for building items_page filters and board insights counts (no schema, no GraphQL round-trip).

NameTypeRequiredDescription

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

fetchModestringoptionalfetchMode "schema": JSON settings schema only (GraphQL). fetchMode "guidelines": guidelines.filter and guidelines.aggregation only — no GraphQL round-trip.

mondaymcp_getform#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 formToken is the alphanumeric string that appears right after /forms/ and before the ?. In the example, the formToken is abc123def456ghi789.1 param▾

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 formToken is the alphanumeric string that appears right after /forms/ and before the ?. In the example, the formToken is abc123def456ghi789.

NameTypeRequiredDescription

formTokenstringrequiredNo description.

mondaymcp_getfullboarddata#INTERNAL USE ONLY - DO NOT CALL THIS TOOL DIRECTLY. This tool is exclusively triggered by UI components and should never be invoked directly by the agent.3 params▾

INTERNAL USE ONLY - DO NOT CALL THIS TOOL DIRECTLY. This tool is exclusively triggered by UI components and should never be invoked directly by the agent.

NameTypeRequiredDescription

boardIdstringrequiredThe ID of the board to fetch complete data for

filtersarrayoptionalThe configuration of filters to apply on the items. Use get_board_info for column ids and types on the board. Before sending the filters, use get_column_type_info with fetchMode "guidelines" and use data.guidelines.filter (null if that type has no documented rules).

filtersOperatorstringoptionalThe operator to use for the filters

mondaymcp_getgraphqlschema#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.2 params▾

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.

NameTypeRequiredDescription

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

random_stringstringoptionalDummy parameter for no-parameter tools

mondaymcp_getmondaydevsprintsboards#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.0 params▾

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.

mondaymcp_getnotetakermeetings#Retrieve notetaker meetings with optional detailed fields. Use include_summary, include_topics, include_action_items, and include_transcript flags to control which details are returned. Use access to filter by meeting access level (OWN, SHARED_WITH_ME, SHARED_WITH_ACCOUNT, ALL). Defaults to OWN. Supports filtering by ids, search term, and cursor-based pagination.9 params▾

Retrieve notetaker meetings with optional detailed fields. Use include_summary, include_topics, include_action_items, and include_transcript flags to control which details are returned. Use access to filter by meeting access level (OWN, SHARED_WITH_ME, SHARED_WITH_ACCOUNT, ALL). Defaults to OWN. Supports filtering by ids, search term, and cursor-based pagination.

NameTypeRequiredDescription

accessstringoptionalFilter meetings by access level. OWN: meetings the user participated in or invited the bot to. SHARED_WITH_ME: meetings shared with the user or their team. SHARED_WITH_ACCOUNT: meetings shared with the entire account. ALL: all meetings the user has access to.

cursorstringoptionalCursor for pagination. Use cursor from the previous page_info to fetch the next page.

idsarrayoptionalFilter by specific meeting IDs. Use this to fetch one or more specific meetings in a single call.

include_action_itemsbooleanoptionalWhether to include action items for each meeting.

include_summarybooleanoptionalWhether to include the AI-generated summary for each meeting.

include_topicsbooleanoptionalWhether to include discussion topics and talking points for each meeting.

include_transcriptbooleanoptionalWhether to include the full transcript for each meeting. Transcripts can be very large.

limitnumberoptionalMaximum number of notetaker meetings to return per page (1-100).

searchstringoptionalSearch notetaker meetings by title, participant name, or email.

mondaymcp_getsprintsmetadata#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.2 params▾

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.

NameTypeRequiredDescription

sprintsBoardIdnumberrequiredThe ID of the monday-dev board containing the sprints

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

mondaymcp_getsprintsummary#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. 1 param▾

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.

NameTypeRequiredDescription

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

mondaymcp_gettypedetails#Get detailed information about a specific GraphQL type from the monday.com API schema1 param▾

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

NameTypeRequiredDescription

typeNamestringrequiredThe name of the GraphQL type to get details for

mondaymcp_getupdates#Get updates (comments/posts) from a monday.com item or board. Specify objectId and objectType (Item or Board) to retrieve updates. For Board queries, you can filter by date range using fromDate and toDate (both required together, ISO8601 format). By default, Board queries return only board discussion. Set includeItemUpdates to true to also include updates on individual items. Returns update text, creator info, timestamps, and optionally replies and assets.9 params▾

Get updates (comments/posts) from a monday.com item or board. Specify objectId and objectType (Item or Board) to retrieve updates. For Board queries, you can filter by date range using fromDate and toDate (both required together, ISO8601 format). By default, Board queries return only board discussion. Set includeItemUpdates to true to also include updates on individual items. Returns update text, creator info, timestamps, and optionally replies and assets.

NameTypeRequiredDescription

objectIdstringrequiredThe ID of the item or board to get updates from

objectTypestringrequiredType of object for which objectId was provided

fromDatestringoptionalStart of date range filter (e.g. "2025-01-01" or "2025-01-01T00:00:00Z"). Must be used together with toDate. Only supported for Board objectType.

includeAssetsbooleanoptionalInclude file attachments in the response

includeItemUpdatesbooleanoptionalWhen objectType is Board, also include updates on individual items. Defaults to false, returning only board discussion. Set to true to retrieve all updates on a board, including updates on individual items.

includeRepliesbooleanoptionalInclude update replies in the response

limitnumberoptionalNumber of updates per page (default: 25, max: 100)

pagenumberoptionalPage number for pagination (default: 1)

toDatestringoptionalEnd of date range filter (e.g. "2025-06-01" or "2025-06-01T23:59:59Z"). Must be used together with fromDate. Only supported for Board objectType.

mondaymcp_getusercontext#Fetch current user information, account information, and their relevant items (boards, folders, workspaces, dashboards). Use this tool to: - Get context about who the current user is (id, name, title) - Get account info: plan tier, active member count, trial status, and active products - Get the number of active members in the account (returns active_members_count) - Discover user's favorite boards, folders, workspaces, and dashboards - Get user's most relevant boards based on visit frequency and recency - Get user's most relevant people based on interaction frequency and recency - Reduce the need for search requests by knowing user's commonly accessed items 0 params▾

Fetch current user information, account information, and their relevant items (boards, folders, workspaces, dashboards). Use this tool to: - Get context about who the current user is (id, name, title) - Get account info: plan tier, active member count, trial status, and active products - Get the number of active members in the account (returns active_members_count) - Discover user's favorite boards, folders, workspaces, and dashboards - Get user's most relevant boards based on visit frequency and recency - Get user's most relevant people based on interaction frequency and recency - Reduce the need for search requests by knowing user's commonly accessed items

mondaymcp_listautomations#List all automations on a specific monday.com board, including their ids, titles, active state, and configuration. When NOT to use: Do not call this tool to get general board information unrelated to automations. Note: Some legacy automations may not appear — mention this if users ask about missing automations. 3 params▾

List all automations on a specific monday.com board, including their ids, titles, active state, and configuration. When NOT to use: Do not call this tool to get general board information unrelated to automations. Note: Some legacy automations may not appear — mention this if users ask about missing automations.

NameTypeRequiredDescription

boardIdstringrequiredThe numeric board ID as a string.

cursorstringoptionalPagination cursor from a previous response. Pass to retrieve the next page of automations.

limitintegeroptionalMaximum number of automations to return. Default: 100.

mondaymcp_listusersandteams#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.7 params▾

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.

NameTypeRequiredDescription

getMebooleanoptional[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.

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

includeTeamsbooleanoptional[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.

namestringoptionalName-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.

teamIdsarrayoptionalSpecific 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.

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

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

mondaymcp_listworkspaces#List all workspaces available to the user, ordered by membership (user's workspaces first). Returns workspaces with their ID, name, and description. [IMPORTANT] To search for workspaces by name, use the "search" tool with searchType WORKSPACES instead — it provides faster and more accurate results.2 params▾

List all workspaces available to the user, ordered by membership (user's workspaces first). Returns workspaces with their ID, name, and description. [IMPORTANT] To search for workspaces by name, use the "search" tool with searchType WORKSPACES instead — it provides faster and more accurate results.

NameTypeRequiredDescription

limitnumberoptionalNumber of workspaces to return. Default is (100), lower for a smaller response size

pagenumberoptionalPage number to return. Default is 1.

mondaymcp_manageagent#Full lifecycle management for monday platform agents — create, read, update, delete, change state, and run. monday platform agents are user-built work orchestrators on monday.com — each has a profile (name, role, avatar), a goal, and a markdown execution plan. Agents in state ACTIVE can be triggered automatically. They are NOT local LangChain or MCP agents. ACTIONS (only pass fields that apply to the chosen action): - create: { action:"create", prompt, agent_model? } — AI-generated agent. Platform creates profile, goal, and plan from the prompt. - create_blank: { action:"create_blank", name?, role?, role_description?, avatar_url?, gender?, background_color?, user_prompt? } — manually defined agent. - get one: { action:"get", agent_id } - list owned: { action:"get" } - update: { action:"update", agent_id, name?, role?, role_description?, plan?, agent_model? } - delete: { action:"delete", agent_id } - activate: { action:"activate", agent_id } - deactivate: { action:"deactivate", agent_id } - run: { action:"run", agent_id } RULES: - "create_blank" with no fields creates a nameless blank agent — only do this intentionally. - "update" requires at least one of name/role/role_description/plan/agent_model. - "update", "delete", "activate", "deactivate", "run" all require "agent_id". - Created agents start INACTIVE. Follow with action:"activate" using the returned agent_id before they can be triggered. - ⚠️ DESTRUCTIVE — "delete" is permanent and irreversible. When the user refers to an agent by name, ALWAYS call action:"get" first to confirm the correct agent_id before deleting. - "run" is fire-and-forget. Returns trigger_uuid — no run-status query exists, treat successful enqueue as the only signal. - Agent state is one of ACTIVE, INACTIVE, ARCHIVED, or FAILED. DELETED only appears as the return value of action:"delete". USAGE EXAMPLES: - AI create: { "action": "create", "prompt": "Run my daily standup every weekday at 9am." } - Manual create:{ "action": "create_blank", "name": "Standup Bot", "role": "Project Manager", "gender": "female" } - Fetch one: { "action": "get", "agent_id": "42" } - List mine: { "action": "get" } - Rename: { "action": "update", "agent_id": "7", "name": "New Name" } - Activate: { "action": "activate", "agent_id": "7" } - Deactivate: { "action": "deactivate", "agent_id": "7" } - Run: { "action": "run", "agent_id": "7" } - Delete: { "action": "delete", "agent_id": "7" } RELATED TOOLS: - agent_catalog — browse available trigger types and skills before wiring them to an agent - manage_agent_triggers — manage which triggers fire this agent automatically - manage_agent_skills — manage which skills this agent can perform - manage_agent_knowledge — manage which boards/docs this agent has access to12 params▾

Full lifecycle management for monday platform agents — create, read, update, delete, change state, and run. monday platform agents are user-built work orchestrators on monday.com — each has a profile (name, role, avatar), a goal, and a markdown execution plan. Agents in state ACTIVE can be triggered automatically. They are NOT local LangChain or MCP agents. ACTIONS (only pass fields that apply to the chosen action): - create: { action:"create", prompt, agent_model? } — AI-generated agent. Platform creates profile, goal, and plan from the prompt. - create_blank: { action:"create_blank", name?, role?, role_description?, avatar_url?, gender?, background_color?, user_prompt? } — manually defined agent. - get one: { action:"get", agent_id } - list owned: { action:"get" } - update: { action:"update", agent_id, name?, role?, role_description?, plan?, agent_model? } - delete: { action:"delete", agent_id } - activate: { action:"activate", agent_id } - deactivate: { action:"deactivate", agent_id } - run: { action:"run", agent_id } RULES: - "create_blank" with no fields creates a nameless blank agent — only do this intentionally. - "update" requires at least one of name/role/role_description/plan/agent_model. - "update", "delete", "activate", "deactivate", "run" all require "agent_id". - Created agents start INACTIVE. Follow with action:"activate" using the returned agent_id before they can be triggered. - ⚠️ DESTRUCTIVE — "delete" is permanent and irreversible. When the user refers to an agent by name, ALWAYS call action:"get" first to confirm the correct agent_id before deleting. - "run" is fire-and-forget. Returns trigger_uuid — no run-status query exists, treat successful enqueue as the only signal. - Agent state is one of ACTIVE, INACTIVE, ARCHIVED, or FAILED. DELETED only appears as the return value of action:"delete". USAGE EXAMPLES: - AI create: { "action": "create", "prompt": "Run my daily standup every weekday at 9am." } - Manual create:{ "action": "create_blank", "name": "Standup Bot", "role": "Project Manager", "gender": "female" } - Fetch one: { "action": "get", "agent_id": "42" } - List mine: { "action": "get" } - Rename: { "action": "update", "agent_id": "7", "name": "New Name" } - Activate: { "action": "activate", "agent_id": "7" } - Deactivate: { "action": "deactivate", "agent_id": "7" } - Run: { "action": "run", "agent_id": "7" } - Delete: { "action": "delete", "agent_id": "7" } RELATED TOOLS: - agent_catalog — browse available trigger types and skills before wiring them to an agent - manage_agent_triggers — manage which triggers fire this agent automatically - manage_agent_skills — manage which skills this agent can perform - manage_agent_knowledge — manage which boards/docs this agent has access to

NameTypeRequiredDescription

actionstringrequired"create" — create a new agent via AI (pass prompt). "create_blank" — create a new agent manually (pass name/role/etc). "get" — fetch one agent by agent_id or list owned agents. "update" — modify mutable fields on an existing agent. "delete" — permanently delete an agent (irreversible). "activate" — transition agent to ACTIVE. "deactivate" — transition agent to INACTIVE. "run" — manually enqueue an agent run (fire-and-forget).

agent_idstringoptionalUsed with action:"get" to fetch a specific agent. Required for action:"update", "delete", "activate", "deactivate", "run". Omit for action:"create", "create_blank", or action:"get" (to list owned agents).

agent_modelstringoptionalUsed with action:"create" or action:"update". Omit unless the user explicitly names a valid monday-supported model.

avatar_urlstringoptionalUsed with action:"create_blank". HTTPS URL of the avatar. Prefer dapulse-res.cloudinary.com or cdn.monday.com.

background_colorstringoptionalUsed with action:"create_blank". Lowercase hex, e.g. "#9450fd".

genderstringoptionalUsed with action:"create_blank". Hint for generated avatar/name when profile fields are omitted.

namestringoptionalUsed with action:"create_blank" or action:"update". Display name of the agent.

planstringoptionalUsed with action:"update". New step-by-step execution plan in markdown.

promptstringoptionalRequired for action:"create". Plain-language description of what the agent should do. Platform generates profile, goal, and plan via AI.

rolestringoptionalUsed with action:"create_blank" or action:"update". Short role title (e.g. "Customer Success Bot").

role_descriptionstringoptionalUsed with action:"create_blank" or action:"update". Detailed description of the agent role.

user_promptstringoptionalUsed with action:"create_blank". Stored as metadata. Not used for AI generation.

mondaymcp_manageagentknowledge#List, grant, update, or revoke a monday platform agent's access to boards and docs. An agent's "knowledge" is the set of monday.com boards and docs it can read from or write to during a run. - list: Returns all resources the agent currently has access to, including permission level and resource type. - add: Grants the agent access to a board or doc with the specified permission level. - update: Changes the permission level on a resource the agent already has access to. Call action:"list" first to confirm the resource_id exists. - remove: Revokes the agent's access to a board or doc entirely. Call action:"list" first to confirm the resource_id exists. Permission types: - READ: Agent can read data from the resource. - READ_WRITE: Agent can read and write data to the resource. USAGE EXAMPLES: - List: { "action": "list", "agent_id": "7" } - Add board access: { "action": "add", "agent_id": "7", "resource_id": "42", "scope_type": "BOARD", "permission_type": "READ" } - Update to read-write: { "action": "update", "agent_id": "7", "resource_id": "42", "scope_type": "BOARD", "permission_type": "READ_WRITE" } - Remove access: { "action": "remove", "agent_id": "7", "resource_id": "42", "scope_type": "BOARD" } RELATED TOOLS: - manage_agent — manage the agent entity itself (create, activate, deactivate, etc.) - manage_agent_triggers — manage which triggers fire this agent automatically - manage_agent_skills — manage which skills this agent can perform5 params▾

List, grant, update, or revoke a monday platform agent's access to boards and docs. An agent's "knowledge" is the set of monday.com boards and docs it can read from or write to during a run. - list: Returns all resources the agent currently has access to, including permission level and resource type. - add: Grants the agent access to a board or doc with the specified permission level. - update: Changes the permission level on a resource the agent already has access to. Call action:"list" first to confirm the resource_id exists. - remove: Revokes the agent's access to a board or doc entirely. Call action:"list" first to confirm the resource_id exists. Permission types: - READ: Agent can read data from the resource. - READ_WRITE: Agent can read and write data to the resource. USAGE EXAMPLES: - List: { "action": "list", "agent_id": "7" } - Add board access: { "action": "add", "agent_id": "7", "resource_id": "42", "scope_type": "BOARD", "permission_type": "READ" } - Update to read-write: { "action": "update", "agent_id": "7", "resource_id": "42", "scope_type": "BOARD", "permission_type": "READ_WRITE" } - Remove access: { "action": "remove", "agent_id": "7", "resource_id": "42", "scope_type": "BOARD" } RELATED TOOLS: - manage_agent — manage the agent entity itself (create, activate, deactivate, etc.) - manage_agent_triggers — manage which triggers fire this agent automatically - manage_agent_skills — manage which skills this agent can perform

NameTypeRequiredDescription

actionstringrequired"list" — returns all resources the agent currently has access to. "add" — grants access to a board or doc. "update" — changes the permission level on an existing resource. "remove" — revokes the agent's access to a board or doc.

agent_idstringrequiredUnique identifier of the agent.

permission_typestringoptionalRequired for action:add and action:update. The permission level: "READ" (agent can read the resource) or "READ_WRITE" (agent can read and write the resource).

resource_idstringoptionalRequired for action:add, action:update, action:remove. The ID of the board or doc to grant/update/revoke access to.

scope_typestringoptionalRequired for action:add, action:update, action:remove. The type of resource: "BOARD" or "DOC".

mondaymcp_manageagentskills#Manage the full skill lifecycle for monday platform agents — create new skills in the catalog, attach skills to an agent, or detach them. Skills extend what an agent can do (e.g. sending emails, querying databases, posting to Slack). ACTIONS: - create: { name, content, description? } — creates a new custom skill in the account-wide catalog. The skill becomes available to all agents in the account. - add: { agent_id, skill_id } — attaches a skill to this agent. - remove: { agent_id, skill_id } — detaches a skill from this agent. WORKFLOW — attach an existing skill: 1. Call agent_catalog action:"list_skills" — find the skill_id of the skill to attach. 2. Call this tool action:"add" with agent_id and that skill_id. WORKFLOW — create a new skill and attach it: 1. Call this tool action:"create" with name and content — note the returned id. 2. Call this tool action:"add" with agent_id and that id directly (no catalog lookup needed). NOTE: There is no action to list which skills are currently attached to a specific agent — the platform does not yet expose that query. To browse all skills available in the account catalog, use agent_catalog action:"list_skills". USAGE EXAMPLES: - Create a skill: { "action": "create", "name": "Send Slack Message", "content": "## Instructions\nPost a message to a Slack channel.", "description": "Sends a message to Slack" } - Add a skill: { "action": "add", "agent_id": "7", "skill_id": "skill-abc-123" } - Remove a skill: { "action": "remove", "agent_id": "7", "skill_id": "skill-abc-123" } RELATED TOOLS: - agent_catalog action:"list_skills" — browse existing skills to find a skill_id before calling action:"add" - manage_agent_triggers — manage which triggers fire this agent automatically - manage_agent — manage the agent entity itself (create, activate, deactivate, etc.)6 params▾

Manage the full skill lifecycle for monday platform agents — create new skills in the catalog, attach skills to an agent, or detach them. Skills extend what an agent can do (e.g. sending emails, querying databases, posting to Slack). ACTIONS: - create: { name, content, description? } — creates a new custom skill in the account-wide catalog. The skill becomes available to all agents in the account. - add: { agent_id, skill_id } — attaches a skill to this agent. - remove: { agent_id, skill_id } — detaches a skill from this agent. WORKFLOW — attach an existing skill: 1. Call agent_catalog action:"list_skills" — find the skill_id of the skill to attach. 2. Call this tool action:"add" with agent_id and that skill_id. WORKFLOW — create a new skill and attach it: 1. Call this tool action:"create" with name and content — note the returned id. 2. Call this tool action:"add" with agent_id and that id directly (no catalog lookup needed). NOTE: There is no action to list which skills are currently attached to a specific agent — the platform does not yet expose that query. To browse all skills available in the account catalog, use agent_catalog action:"list_skills". USAGE EXAMPLES: - Create a skill: { "action": "create", "name": "Send Slack Message", "content": "## Instructions\nPost a message to a Slack channel.", "description": "Sends a message to Slack" } - Add a skill: { "action": "add", "agent_id": "7", "skill_id": "skill-abc-123" } - Remove a skill: { "action": "remove", "agent_id": "7", "skill_id": "skill-abc-123" } RELATED TOOLS: - agent_catalog action:"list_skills" — browse existing skills to find a skill_id before calling action:"add" - manage_agent_triggers — manage which triggers fire this agent automatically - manage_agent — manage the agent entity itself (create, activate, deactivate, etc.)

NameTypeRequiredDescription

actionstringrequired"create" — author a new custom skill in the account-wide catalog (no agent_id needed). "add" — attach an existing skill to this agent by skill_id. "remove" — detach a skill from this agent.

agent_idstringoptionalRequired for action:"add" and action:"remove". Not used for action:"create" (account-level operation).

contentstringoptionalRequired for action:"create". Markdown instructions defining what the skill does and how to execute it. Be specific and thorough — this is the skill's runtime behavior.

descriptionstringoptionalUsed with action:"create". Short description shown in the catalog.

namestringoptionalRequired for action:"create". Display name of the new skill.

skill_idstringoptionalRequired for action:"add" and action:"remove". The skill id from agent_catalog action:"list_skills", or the id returned by action:"create" in this tool. Never guess or invent a skill id.

mondaymcp_manageagenttriggers#Manage the triggers attached to a monday platform agent — triggers define WHEN the agent runs automatically. ACTIONS: - list: { agent_id } — returns active triggers with node_id, block_reference_id, name, field_summary. - add: { agent_id, block_reference_id, field_values? } — attaches a trigger type to the agent. - remove: { agent_id, node_id } — detaches a trigger instance by node_id (NOT block_reference_id). WORKFLOW — add a trigger: 1. Call agent_catalog action:"list_triggers" — note block_reference_id, field_schemas, and required_fields. 2. Collect required field values from the user (e.g. board_id, column_id). 3. Call this tool action:"add" with block_reference_id and field_values. Note: add returns only { success } — no node_id for the new instance. Call action:"list" afterward if you need the node_id. WORKFLOW — remove a trigger: 1. Call action:"list" to see active triggers and note the node_id of the instance to remove. 2. Call action:"remove" with that node_id. NOTE: Only triggers that can be added programmatically appear in the catalog. OAuth/3rd-party triggers (Slack, Gmail, Salesforce, etc.) require user setup in the monday.com UI — they will not appear in agent_catalog and cannot be managed here. USAGE EXAMPLES: - List triggers: { "action": "list", "agent_id": "7" } - Add trigger: { "action": "add", "agent_id": "7", "block_reference_id": "status-change-ref", "field_values": { "board_id": "42" } } - Remove trigger: { "action": "remove", "agent_id": "7", "node_id": "node-abc" } RELATED TOOLS: - agent_catalog action:"list_triggers" — discover available trigger types and their required field_values before calling action:"add" here - manage_agent_skills — manage which skills this agent can perform - manage_agent — manage the agent entity itself (create, activate, deactivate, etc.)5 params▾

Manage the triggers attached to a monday platform agent — triggers define WHEN the agent runs automatically. ACTIONS: - list: { agent_id } — returns active triggers with node_id, block_reference_id, name, field_summary. - add: { agent_id, block_reference_id, field_values? } — attaches a trigger type to the agent. - remove: { agent_id, node_id } — detaches a trigger instance by node_id (NOT block_reference_id). WORKFLOW — add a trigger: 1. Call agent_catalog action:"list_triggers" — note block_reference_id, field_schemas, and required_fields. 2. Collect required field values from the user (e.g. board_id, column_id). 3. Call this tool action:"add" with block_reference_id and field_values. Note: add returns only { success } — no node_id for the new instance. Call action:"list" afterward if you need the node_id. WORKFLOW — remove a trigger: 1. Call action:"list" to see active triggers and note the node_id of the instance to remove. 2. Call action:"remove" with that node_id. NOTE: Only triggers that can be added programmatically appear in the catalog. OAuth/3rd-party triggers (Slack, Gmail, Salesforce, etc.) require user setup in the monday.com UI — they will not appear in agent_catalog and cannot be managed here. USAGE EXAMPLES: - List triggers: { "action": "list", "agent_id": "7" } - Add trigger: { "action": "add", "agent_id": "7", "block_reference_id": "status-change-ref", "field_values": { "board_id": "42" } } - Remove trigger: { "action": "remove", "agent_id": "7", "node_id": "node-abc" } RELATED TOOLS: - agent_catalog action:"list_triggers" — discover available trigger types and their required field_values before calling action:"add" here - manage_agent_skills — manage which skills this agent can perform - manage_agent — manage the agent entity itself (create, activate, deactivate, etc.)

NameTypeRequiredDescription

actionstringrequired"list" — returns all triggers currently attached to this agent (includes node_id needed for remove). "add" — attaches a new trigger by block_reference_id. "remove" — detaches a trigger instance by node_id.

agent_idstringrequiredUnique identifier of the agent.

block_reference_idstringoptionalRequired for action:"add". The block_reference_id from agent_catalog action:"list_triggers" identifying the trigger type to attach. Never guess this value — look it up in the catalog first.

field_valuesobjectoptionalUsed with action:"add" when the trigger type has required_fields. Key/value object whose shape is described by field_schemas in the agent_catalog response. Scalar fields use string/number/boolean values. Selection fields use { "value": "<id>", "label": "<name>" }.

node_idstringoptionalRequired for action:"remove". The node_id of the trigger instance — get it from action:"list". Each instance has a unique node_id even if the same trigger type is attached multiple times. Do NOT pass block_reference_id here.

mondaymcp_manageautomations#Activate, deactivate, or delete an existing monday.com automation. Requires an automation id. When the user refers to an automation by name, always call list_automations first to resolve the id — never guess or infer ids. Actions: - activate: enables a paused automation so it starts responding to its trigger. - deactivate: pauses an automation while preserving its definition. - delete: permanently removes an automation — irreversible. When intent is ambiguous ("stop", "turn off", "pause"), prefer deactivate over delete.2 params▾

Activate, deactivate, or delete an existing monday.com automation. Requires an automation id. When the user refers to an automation by name, always call list_automations first to resolve the id — never guess or infer ids. Actions: - activate: enables a paused automation so it starts responding to its trigger. - deactivate: pauses an automation while preserving its definition. - delete: permanently removes an automation — irreversible. When intent is ambiguous ("stop", "turn off", "pause"), prefer deactivate over delete.

NameTypeRequiredDescription

actionstringrequiredThe operation to perform. activate: enables a paused automation so it responds to its trigger. deactivate: pauses an automation without deleting it. delete: permanently removes an automation (irreversible).

workflowIdstringrequiredThe automation ID to operate on. Obtain from list_automations.

mondaymcp_moveobject#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.8 params▾

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.

NameTypeRequiredDescription

idstringrequiredThe ID of the object to move

objectTypestringrequiredThe type of object to move

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

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

position_is_afterbooleanoptionalWhether to position the object after the object

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

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

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

mondaymcp_planworkflow#Plans one or more monday.com workflows for a described process using an AI agent. The agent analyzes the prompt, decides how many workflows are needed, identifies the required boards and columns, selects the correct trigger and action blocks (with their IDs), and returns a structured implementation plan with Mermaid diagrams and build notes for each workflow. Use this before create_workflow to understand how to break a complex process into individual workflows and which resources to create first. Parameters: - prompt: describe the full end-to-end process in plain English. Maximum 2000 characters. Returns: - result: structured markdown plan with workflow breakdowns, block IDs, resource definitions, and a list of assumptions and gaps 1 param▾

Plans one or more monday.com workflows for a described process using an AI agent. The agent analyzes the prompt, decides how many workflows are needed, identifies the required boards and columns, selects the correct trigger and action blocks (with their IDs), and returns a structured implementation plan with Mermaid diagrams and build notes for each workflow. Use this before create_workflow to understand how to break a complex process into individual workflows and which resources to create first. Parameters: - prompt: describe the full end-to-end process in plain English. Maximum 2000 characters. Returns: - result: structured markdown plan with workflow breakdowns, block IDs, resource definitions, and a list of assumptions and gaps

NameTypeRequiredDescription

promptstringrequiredNatural-language description of the process to plan. Describe the full end-to-end process in plain English (e.g. "When a deal is marked Won, create a task in the onboarding board and notify the account manager"). The agent will decompose this into one or more monday.com workflows, identify all required boards and columns, and return a structured implementation plan. Maximum 2000 characters.

mondaymcp_publishworkflow#Publishes a workflow draft, promoting it to the live version. Use this after create_workflow (and optionally update_workflow) to make the workflow active. Before publishing, the workflow is validated — if it has missing or misconfigured steps, publish will fail with a WORKFLOW_VALIDATION_FAILED error that includes structured issue details: which step failed, the issue type, and which inputs are missing. Use those details to guide the user on what to fix before retrying. Parameters: - workflowObjectId and workflowDraftId: returned by create_workflow — they identify which draft to publish. - shouldActivate: whether to activate the workflow immediately after publish. Defaults to true — pass false to publish without activating. Returns: - workflowObjectId: the workflow object ID (unchanged) - workflowLiveId: the new live version ID — this changes on every publish, so do not cache it Note: if directing the user to the workflow in the UI, the correct URL path is custom_objects/, not workflows/ — e.g. {account}.monday.com/custom_objects/{workflowObjectId}. 3 params▾

Publishes a workflow draft, promoting it to the live version. Use this after create_workflow (and optionally update_workflow) to make the workflow active. Before publishing, the workflow is validated — if it has missing or misconfigured steps, publish will fail with a WORKFLOW_VALIDATION_FAILED error that includes structured issue details: which step failed, the issue type, and which inputs are missing. Use those details to guide the user on what to fix before retrying. Parameters: - workflowObjectId and workflowDraftId: returned by create_workflow — they identify which draft to publish. - shouldActivate: whether to activate the workflow immediately after publish. Defaults to true — pass false to publish without activating. Returns: - workflowObjectId: the workflow object ID (unchanged) - workflowLiveId: the new live version ID — this changes on every publish, so do not cache it Note: if directing the user to the workflow in the UI, the correct URL path is custom_objects/, not workflows/ — e.g. {account}.monday.com/custom_objects/{workflowObjectId}.

NameTypeRequiredDescription

workflowDraftIdstringrequiredThe draft version ID returned by create_workflow. Both workflowObjectId and workflowDraftId are required — together they identify the exact draft to publish.

workflowObjectIdstringrequiredThe workflow object ID returned by create_workflow. Identifies the workflow across all its drafts and live versions.

shouldActivatebooleanoptionalWhether to activate the workflow immediately after publishing so it starts running. Defaults to true — the workflow is activated immediately after publish.

mondaymcp_readdocs#Get information about monday.com documents. Supports two modes: MODE: "content" (default) — Fetch documents with their full markdown content. - Requires: type ("ids" | "object_ids" | "workspace_ids") and ids array - Supports pagination via page/limit. Check has_more_pages in response. - If type "ids" returns no results, automatically retries with object_ids. - Set include_blocks: true to include block IDs, types, and positions in the response — required before calling update_doc. - Blocks default to 25 per page. Use blocks_limit and blocks_page to paginate through long documents. - Set include_comments: true to fetch all comments and replies on the document. Each comment is enriched with anchor info (block_id, selection_from, selection_length) indicating which block and text range it's attached to. Use comments_limit to control how many comments per item (default 50). MODE: "version_history" — Fetch the edit history of a single document. - Requires: ids with the document's object_id (use the object_id field from content mode results, NOT the id field). - The object_id is the numeric ID visible in the document URL. - Returns restoring points sorted newest-first. Use version_history_limit to cap results (e.g., "last 3 changes" → version_history_limit: 3). - Use since/until to filter by time range. If omitted, returns full history. - Set include_diff: true to see what content changed between versions (fetches up to 10 diffs, may be slower). - Examples: - { mode: "version_history", ids: ["5001466606"], version_history_limit: 3 } - { mode: "version_history", ids: ["5001466606"], since: "2026-03-11T00:00:00Z", include_diff: true }15 params▾

Get information about monday.com documents. Supports two modes: MODE: "content" (default) — Fetch documents with their full markdown content. - Requires: type ("ids" | "object_ids" | "workspace_ids") and ids array - Supports pagination via page/limit. Check has_more_pages in response. - If type "ids" returns no results, automatically retries with object_ids. - Set include_blocks: true to include block IDs, types, and positions in the response — required before calling update_doc. - Blocks default to 25 per page. Use blocks_limit and blocks_page to paginate through long documents. - Set include_comments: true to fetch all comments and replies on the document. Each comment is enriched with anchor info (block_id, selection_from, selection_length) indicating which block and text range it's attached to. Use comments_limit to control how many comments per item (default 50). MODE: "version_history" — Fetch the edit history of a single document. - Requires: ids with the document's object_id (use the object_id field from content mode results, NOT the id field). - The object_id is the numeric ID visible in the document URL. - Returns restoring points sorted newest-first. Use version_history_limit to cap results (e.g., "last 3 changes" → version_history_limit: 3). - Use since/until to filter by time range. If omitted, returns full history. - Set include_diff: true to see what content changed between versions (fetches up to 10 diffs, may be slower). - Examples: - { mode: "version_history", ids: ["5001466606"], version_history_limit: 3 } - { mode: "version_history", ids: ["5001466606"], since: "2026-03-11T00:00:00Z", include_diff: true }

NameTypeRequiredDescription

blocks_limitnumberoptionalMaximum number of blocks to return per document (default: 25). Only used in content mode when include_blocks is true.

blocks_pagenumberoptionalPage number for block pagination, starting at 1. Omit to use the API default. Use with blocks_limit to page through documents with more than 25 blocks. Only used in content mode when include_blocks is true.

comments_limitnumberoptionalMaximum number of comments (updates) to fetch per item when include_comments is true. Defaults to 50. Only used in content mode.

idsarrayoptionalArray of ID values. In content mode: matches the query type (ids/object_ids/workspace_ids). In version_history mode: provide the single document object_id here (e.g., ids: ["5001466606"]).

include_blocksbooleanoptionalIf true, includes the blocks array (block IDs, types, positions, content) in the response. Required when you plan to call update_doc. Defaults to false to reduce response size. Only used in content mode.

include_commentsbooleanoptionalIf true, fetches all comments and replies on the document. Comments are stored at the item level within the doc backing board. Defaults to false. Only used in content mode.

include_diffbooleanoptionalIf true, fetches content diffs between consecutive restoring points. May be slower due to additional API calls. Only used in version_history mode.

limitnumberoptionalNumber of docs per page (default: 25). Only used in content mode.

modestringoptionalThe operation mode. "content" (default) fetches documents with their markdown content. "version_history" fetches the edit history of a single document.

order_bystringoptionalOrder in which to retrieve docs. Only used in content mode.

pagenumberoptionalPage number to return (starts at 1). Only used in content mode.

sincestringoptionalISO 8601 date string to filter version history from (e.g., "2026-03-15T00:00:00Z"). If omitted, returns the full history. Only used in version_history mode.

typestringoptionalQuery type for content mode: "ids", "object_ids", or "workspace_ids". Required when mode is "content".

untilstringoptionalISO 8601 date string to filter version history until (e.g., "2026-03-16T23:59:59Z"). Defaults to now. Only used in version_history mode.

version_history_limitnumberoptionalMaximum number of restoring points to return. Use this when the user asks for "last N changes". Only used in version_history mode.

mondaymcp_search#Search within monday.com platform. Can search for boards, documents, folders, workspaces, updates, and items. For searching/listing specific users and teams, use list_users_and_teams tool. For account-level info (plan, member count, products), use get_user_context tool. For groups, use get_board_info tool. ITEMS search requires a searchTerm and only returns id, title, and url. WORKSPACES search requires a searchTerm and only returns id, title, and description. UPDATES search requires a searchTerm and returns id, title (the update body), itemId, boardId, and creatorId. Optionally scope it with boardIds and/or creatorIds. IMPORTANT: ids returned by this tool are prefixed with the type of the object (e.g doc-123, board-456, folder-789, workspace-101, update-303, item-321). When passing the ids to other tools, you need to remove the prefix and just pass the number. 7 params▾

Search within monday.com platform. Can search for boards, documents, folders, workspaces, updates, and items. For searching/listing specific users and teams, use list_users_and_teams tool. For account-level info (plan, member count, products), use get_user_context tool. For groups, use get_board_info tool. ITEMS search requires a searchTerm and only returns id, title, and url. WORKSPACES search requires a searchTerm and only returns id, title, and description. UPDATES search requires a searchTerm and returns id, title (the update body), itemId, boardId, and creatorId. Optionally scope it with boardIds and/or creatorIds. IMPORTANT: ids returned by this tool are prefixed with the type of the object (e.g doc-123, board-456, folder-789, workspace-101, update-303, item-321). When passing the ids to other tools, you need to remove the prefix and just pass the number.

NameTypeRequiredDescription

searchTypestringrequiredThe type of search to perform.

boardIdsarrayoptionalThe ids of the boards to scope the search to. [IMPORTANT] Only applies to UPDATES search, and only pass it if the user explicitly asked to search within specific boards.

creatorIdsarrayoptionalThe ids of the users whose updates to search. [IMPORTANT] Only applies to UPDATES search, and only pass it if the user explicitly asked to search updates by specific authors.

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

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

searchTermstringoptionalThe search term to use for the search.

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

mondaymcp_updatedoc#Update an existing monday.com document. Provide doc_id (preferred) or object_id, plus an ordered operations array (executed sequentially, stops on first failure). OPERATIONS: - set_name: Rename the document. - add_markdown_content: Append markdown as blocks (or insert after a block). Best for text, headings, lists, simple tables — no block IDs needed. - update_block: Update content of an existing text, code, or list_item block in-place. - create_block: Create a new block at a precise position. Use parent_block_id to nest inside notice_box, table cell, or layout cell. - delete_block: Remove any block. The ONLY option for BOARD, WIDGET, DOC embed, and GIPHY blocks. - replace_block: Delete a block and create a new one in its place (use when update_block is not supported). - add_comment: Create a new comment or reply on the document (doc-level, block-level, or text-selection). WHEN TO USE EACH OPERATION: - text / code / list_item → update_block. Use replace_block to change subtype (e.g. NORMAL_TEXT→LARGE_TITLE) - divider / table / image / video / notice_box / layout → replace_block (properties immutable after creation) - BOARD / WIDGET / DOC / GIPHY → delete_block only GETTING BLOCK IDs: Call read_docs with include_blocks: true — returns id, type, position, and content per block. BLOCK CONTENT (delta_format): Array of insert ops. Last op MUST be {insert: {text: "\n"}}. - Plain: [{insert: {text: "Hello"}}, {insert: {text: "\n"}}] - Bold: [{insert: {text: "Hi"}, attributes: {bold: true}}, {insert: {text: "\n"}}] - Mention user/doc/board: [{insert: {text: "Hey "}}, {insert: {mention: {id: 12345, type: "USER"}}}, {insert: {text: "\n"}}] — type is USER, DOC, or BOARD. id is numeric (user IDs from list_users_and_teams) - Inline column value: [{insert: {column_value: {item_id: 111, column_id: "status"}}}, {insert: {text: "\n"}}] - Supported attributes: bold, italic, underline, strike, code, link, color, background (not applicable to mention/column_value ops) IMAGE WITH ASSET: For asset-based images, use create_block with block_type "image" and asset_id (instead of public_url). add_markdown_content does NOT support asset images — for mixed content, alternate add_markdown_content (text) and create_block (image) operations in sequence. COMMENTS: - add_comment: Create a new comment or reply on the document. Three scopes: - Doc-level (no block_id): comment appears on the doc as a whole. - Block-level (block_id only): comment is anchored to a specific block. The block shows a comment indicator in the UI. - Text-selection (block_id + selection_from + selection_length): comment is anchored to a specific character range inside a text/code/list_item block. That text is highlighted with a comment marker. Block-level and text-selection comments only work on blocks with text content (text, code, list_item, title, quote). They do NOT work on: divider, page_break, table, layout, notice_box, image, video, or giphy blocks. Get block IDs from read_docs with include_blocks: true. Format body with HTML, not markdown. Use mentions_list for @mentions.3 params▾

Update an existing monday.com document. Provide doc_id (preferred) or object_id, plus an ordered operations array (executed sequentially, stops on first failure). OPERATIONS: - set_name: Rename the document. - add_markdown_content: Append markdown as blocks (or insert after a block). Best for text, headings, lists, simple tables — no block IDs needed. - update_block: Update content of an existing text, code, or list_item block in-place. - create_block: Create a new block at a precise position. Use parent_block_id to nest inside notice_box, table cell, or layout cell. - delete_block: Remove any block. The ONLY option for BOARD, WIDGET, DOC embed, and GIPHY blocks. - replace_block: Delete a block and create a new one in its place (use when update_block is not supported). - add_comment: Create a new comment or reply on the document (doc-level, block-level, or text-selection). WHEN TO USE EACH OPERATION: - text / code / list_item → update_block. Use replace_block to change subtype (e.g. NORMAL_TEXT→LARGE_TITLE) - divider / table / image / video / notice_box / layout → replace_block (properties immutable after creation) - BOARD / WIDGET / DOC / GIPHY → delete_block only GETTING BLOCK IDs: Call read_docs with include_blocks: true — returns id, type, position, and content per block. BLOCK CONTENT (delta_format): Array of insert ops. Last op MUST be {insert: {text: "\n"}}. - Plain: [{insert: {text: "Hello"}}, {insert: {text: "\n"}}] - Bold: [{insert: {text: "Hi"}, attributes: {bold: true}}, {insert: {text: "\n"}}] - Mention user/doc/board: [{insert: {text: "Hey "}}, {insert: {mention: {id: 12345, type: "USER"}}}, {insert: {text: "\n"}}] — type is USER, DOC, or BOARD. id is numeric (user IDs from list_users_and_teams) - Inline column value: [{insert: {column_value: {item_id: 111, column_id: "status"}}}, {insert: {text: "\n"}}] - Supported attributes: bold, italic, underline, strike, code, link, color, background (not applicable to mention/column_value ops) IMAGE WITH ASSET: For asset-based images, use create_block with block_type "image" and asset_id (instead of public_url). add_markdown_content does NOT support asset images — for mixed content, alternate add_markdown_content (text) and create_block (image) operations in sequence. COMMENTS: - add_comment: Create a new comment or reply on the document. Three scopes: - Doc-level (no block_id): comment appears on the doc as a whole. - Block-level (block_id only): comment is anchored to a specific block. The block shows a comment indicator in the UI. - Text-selection (block_id + selection_from + selection_length): comment is anchored to a specific character range inside a text/code/list_item block. That text is highlighted with a comment marker. Block-level and text-selection comments only work on blocks with text content (text, code, list_item, title, quote). They do NOT work on: divider, page_break, table, layout, notice_box, image, video, or giphy blocks. Get block IDs from read_docs with include_blocks: true. Format body with HTML, not markdown. Use mentions_list for @mentions.

NameTypeRequiredDescription

operationsarrayrequiredOrdered list of operations to perform. Executed sequentially. Stops at first failure. Operation types: - set_name: Rename the document. - add_markdown_content: Append markdown as blocks (simplest for text/lists/tables). - update_block: Change content of an existing text/code/list/divider block. - create_block: Create a new block at a specific position (supports text, list_item, code, divider, page_break, image, video, notice_box, table, layout). - delete_block: Permanently remove a block. Works for ALL block types including BOARD, WIDGET, DOC embed, GIPHY. - replace_block: Delete a block and create a new one in its place. Use for: changing image/video source, table restructure, notice_box theme change. - add_comment: Create a new comment or reply on the document. Use parent_update_id to reply to an existing comment. Format text with HTML. Uses the doc's backing board item. WHEN TO USE WHICH: - Adding new text sections → add_markdown_content - Adding asset-based images → create_block with block_type "image" and asset_id (add_markdown_content does NOT support asset images) - Mixed content with asset images → alternate add_markdown_content (for text) and create_block (for each image) in sequence - Editing existing text block → update_block - Changing an image URL → replace_block (image URL is immutable after creation) - Changing video URL → replace_block - Restructuring a table → replace_block - BOARD/WIDGET/DOC/GIPHY blocks → delete_block only (no public API to create these) NESTING CONTENT IN CONTAINERS: - notice_box: Fully supported. Create the notice_box first, then in a separate call create child blocks with parent_block_id set to the notice_box ID. You cannot reference a block ID created in the same call. - table: Cell-level API nesting is NOT supported. To create a table with content, use add_markdown_content with a markdown table (e.g. "| H1 | H2 |\n| --- | --- |\n| A | B |"). This creates a pre-populated table in one shot. Empty tables created via create_block cannot have their cells populated through the API. - layout: Cell-level API nesting is NOT supported and there is no markdown equivalent. Layouts can only be created empty via create_block. No workaround exists to populate layout columns through the API. Deleting a container does NOT delete its children — delete children first for clean removal. Block IDs are available in the blocks array returned by read_docs.

doc_idstringoptionalThe document ID (the id field from read_docs). Takes priority over object_id if both are provided.

object_idstringoptionalThe document object ID (the object_id field from read_docs, visible in the document URL). Resolved to doc_id.

mondaymcp_updatefolder#Update an existing folder in monday.com11 params▾

Update an existing folder in monday.com

NameTypeRequiredDescription

folderIdstringrequiredThe ID of the folder to update

accountProductIdstringoptionalThe account product ID associated with the folder

colorstringoptionalThe new color of the folder

customIconstringoptionalThe new custom icon of the folder

fontWeightstringoptionalThe new font weight of the folder

namestringoptionalThe new name of the folder

parentFolderIdstringoptionalThe ID of the new parent folder

position_is_afterbooleanoptionalWhether to position the folder after the object

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

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

workspaceIdstringoptionalThe ID of the workspace containing the folder

mondaymcp_updateform#Update a monday.com form. Use the action field to specify the operation.5 params▾

Update a monday.com form. Use the action field to specify the operation.

NameTypeRequiredDescription

actionstringrequiredAction to execute on the form. Each action requires different fields — check field descriptions to know what to include.

formTokenstringrequiredNo description.

formobjectoptionalForm data to update (patch semantics).

formPasswordstringoptionalRequired for setFormPassword action.

tagobjectoptionalTag to create/update/delete. Delete: id only. Create: name+value (id/columnId auto-generated). Update: id+new value.

mondaymcp_updateview#Update an existing board view (tab) — change its name, filter rules, or sort order. Provide only the fields you want to change. Omitted fields are left unchanged. Filter operators: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text Example filter for people column: { "rules": [{ "column_id": "people", "compare_value": ["person-12345"], "operator": "any_of" }] } Example filter for status column: { "rules": [{ "column_id": "status", "compare_value": [1], "operator": "any_of" }] }7 params▾

Update an existing board view (tab) — change its name, filter rules, or sort order. Provide only the fields you want to change. Omitted fields are left unchanged. Filter operators: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text Example filter for people column: { "rules": [{ "column_id": "people", "compare_value": ["person-12345"], "operator": "any_of" }] } Example filter for status column: { "rules": [{ "column_id": "status", "compare_value": [1], "operator": "any_of" }] }

NameTypeRequiredDescription

boardIdstringrequiredThe board ID the view belongs to

viewIdstringrequiredThe ID of the view to update

filterobjectoptionalFilter configuration to apply to the view

namestringoptionalNew name for the view (omit to leave unchanged)

settingsstringoptionalType-specific view settings as a JSON object (e.g. column visibility, group_by for TABLE). The shape varies by view type — call get_view_schema_by_type with the same ViewKind to discover the supported structure. For TABLE views, prefer the dedicated update_view_table tool which exposes a strongly-typed settings field.

sortarrayoptionalSort configuration for the view

typestringoptionalThe type of the board view being updated. Use TABLE for standard board views.

mondaymcp_updateviewtable#Update an existing table-type board view — change its name, filters, sort, tags, or table-specific settings (column visibility/order and group-by). Provide only the fields you want to change. Omitted fields are left unchanged. Filter operators: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text Example settings.columns: { "column_properties": [{ "column_id": "status", "visible": true }], "column_order": ["name", "status", "date"] } Example settings.group_by: { "conditions": [{ "columnId": "status" }], "hideEmptyGroups": true }7 params▾

Update an existing table-type board view — change its name, filters, sort, tags, or table-specific settings (column visibility/order and group-by). Provide only the fields you want to change. Omitted fields are left unchanged. Filter operators: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text Example settings.columns: { "column_properties": [{ "column_id": "status", "visible": true }], "column_order": ["name", "status", "date"] } Example settings.group_by: { "conditions": [{ "columnId": "status" }], "hideEmptyGroups": true }

NameTypeRequiredDescription

boardIdstringrequiredThe board ID the view belongs to

viewIdstringrequiredThe ID of the table view to update

filterobjectoptionalFilter configuration to apply to the view

namestringoptionalNew name for the view (omit to leave unchanged)

settingsobjectoptionalTable-specific view settings (column visibility/order, group-by)

sortarrayoptionalSort configuration for the view

tagsarrayoptionalTags to apply to the view

mondaymcp_updateworkflow#Updates an existing workflow draft using an AI agent. The agent interprets the prompt and applies structural changes to the workflow — creating, updating, or deleting steps. Pass clear, descriptive instructions and the agent will decide which operations to perform, then return a summary of what it did. Use this after create_workflow to build out the workflow step by step. You can call it multiple times on the same draft to iteratively refine the workflow. Parameters: - workflowObjectId and workflowDraftId: both returned by create_workflow — they identify which draft to update. - prompt: describe what you want to change in plain English (e.g. "Add a trigger that fires when an item is created on the Marketing board"). Maximum 2000 characters. Returns: - workflowObjectId: the workflow object ID (unchanged) - workflowDraftId: the draft version ID (unchanged) - result: agent response describing the changes made Note: if directing the user to the workflow in the UI, the correct URL path is custom_objects/, not workflows/ — e.g. {account}.monday.com/custom_objects/{workflowObjectId}. Note: the workflow runs only after it is published to live version. 3 params▾

Updates an existing workflow draft using an AI agent. The agent interprets the prompt and applies structural changes to the workflow — creating, updating, or deleting steps. Pass clear, descriptive instructions and the agent will decide which operations to perform, then return a summary of what it did. Use this after create_workflow to build out the workflow step by step. You can call it multiple times on the same draft to iteratively refine the workflow. Parameters: - workflowObjectId and workflowDraftId: both returned by create_workflow — they identify which draft to update. - prompt: describe what you want to change in plain English (e.g. "Add a trigger that fires when an item is created on the Marketing board"). Maximum 2000 characters. Returns: - workflowObjectId: the workflow object ID (unchanged) - workflowDraftId: the draft version ID (unchanged) - result: agent response describing the changes made Note: if directing the user to the workflow in the UI, the correct URL path is custom_objects/, not workflows/ — e.g. {account}.monday.com/custom_objects/{workflowObjectId}. Note: the workflow runs only after it is published to live version.

NameTypeRequiredDescription

promptstringrequiredNatural-language description of the changes to make. Describe what steps to add, remove, or modify in plain English (e.g. "Add a trigger that fires when an item is created on the Marketing board"). The agent interprets this and applies the right structural changes. Maximum 2000 characters.

workflowDraftIdnumberrequiredThe draft version ID to update. Use the workflowDraftId from the previous create_workflow or update_workflow response — the agent may return a new draft ID, so always read it from the latest response rather than reusing an earlier value.

workflowObjectIdnumberrequiredThe workflow object ID returned by create_workflow. Identifies the workflow across all its drafts and published versions. Does not change across publishes.

mondaymcp_updateworkspace#Update an existing workspace in monday.com5 params▾

Update an existing workspace in monday.com

NameTypeRequiredDescription

idstringrequiredThe ID of the workspace to update

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

attributeDescriptionstringoptionalThe description of the workspace to update

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

attributeNamestringoptionalThe name of the workspace to update

mondaymcp_workspaceinfo#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.1 param▾

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.

NameTypeRequiredDescription

workspace_idnumberrequiredThe ID of the workspace to get information for