01
Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
Monday MCP
36 tools available
monday.com is a work management platform for organizing projects, workflows, and customer processes in boards, docs, and dashboards. It helps teams plan work, track progress, and collaborate across functions.
Connect Monday MCP to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Monday MCP's 36 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Common workflows with Monday MCP
02
Daily summary
- Pull yesterday's activity
- Summarise with the model of your choice
- Send the digest via email or Slack
03
Cross-tool sync
- Read records from one app
- Transform with a persona
- Write the result back via this integration
Monday MCP actions 36
Every Monday MCP action below is a callable tool any Definable persona can invoke.
All monday api
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.
All widgets schema
Fetch complete JSON Schema 7 definitions for all available widget types in monday.com. This tool is essential before creating widgets as it provides: - Complete schema definitions for all supported widgets - Required and optional fields for each widget type - Data type specifications and validation rules - Detailed descriptions of widget capabilities Use this tool when you need to: - Understand widget configuration requirements before creating widgets - Validate widget settings against official schemas - Plan widget implementations with proper data structures The response includes JSON Schema 7 definitions that describe exactly what settings each widget type accepts.
Board insights
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.
Change item column values
Change the column values of an item in a monday.com board
Create board
Create a monday.com board
Create column
Create a new column in a monday.com board
Create dashboard
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
Create doc
Create a new monday.com doc either inside a workspace or attached to an item (via a doc column). After creation, the provided markdown will be appended to the document. LOCATION TYPES: - workspace: Creates a document in a workspace (requires workspace_id, optional doc_kind, optional folder_id) - item: Creates a document attached to an item (requires item_id, optional column_id) USAGE EXAMPLES: - Workspace doc: { location: "workspace", workspace_id: 123, doc_kind: "private" , markdown: "..." } - Workspace doc in folder: { location: "workspace", workspace_id: 123, folder_id: 17264196 , markdown: "..." } - Item doc: { location: "item", item_id: 456, column_id: "doc_col_1" , markdown: "..." }
Create folder
Create a new folder in a monday.com workspace
Create form
Create a monday.com form. This will create a new form as well as a new board for which the form’s responses will be stored. The returned board_id is the ID of the board that was created while the returned formToken can be used for all future queries and mutations to continue editing the form.
Create group
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
Create item
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.
Create update
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.
Create widget
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
Create workspace
Create a new workspace in monday.com
Form questions editor
Create, update, or delete a question in a monday.com form
Get board activity
Get board activity logs for a specified time range (defaults to last 30 days)
Get board info
Get comprehensive board information including metadata, structure, owners, and configuration
Get board items page
Get all items from a monday.com board with pagination support and optional column values. Returns structured JSON with item details, creation/update timestamps, and pagination info. Use the 'nextCursor' parameter from the response to get the next page of results when 'has_more' is true.[REQUIRED PRECONDITION]: Before using this tool, if new columns were added to the board or if you are not familiar with the board's structure (column IDs, column types, status labels, etc.), first use get_board_info to understand the board metadata. This is essential for constructing proper filters and knowing which columns are available.
Get column type info
Retrieves comprehensive information about a specific column type, including JSON schema definition and other metadata. Use this before creating columns with the create_column tool to understand the structure, validation rules, and available properties for column settings.
Get form
Get a monday.com form by its form token. Form tokens can be extracted from the form’s url. Given a form url, such as https://forms.monday.com/forms/abc123def456ghi789?r=use1, the token is the alphanumeric string that appears right after /forms/ and before the ?. In the example, the token is abc123def456ghi789.
Get graphql schema
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.
Get monday dev sprints boards
Discover monday-dev sprints boards and their associated tasks boards in your account. ## Purpose: Identifies and returns monday-dev sprints board IDs and tasks board IDs that you need to use with other monday-dev tools. This tool scans your recently used boards (up to 100) to find valid monday-dev sprint management boards. ## What it Returns: - Pairs of sprints boards and their corresponding tasks boards - Board IDs, names, and workspace information for each pair - The bidirectional relationship between each sprints board and its tasks board ## Note: Searches recently used boards (up to 100). If none found, ask user to provide board IDs manually.
Get sprints metadata
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.
Get sprint summary
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.
Get type details
Get detailed information about a specific GraphQL type from the monday.com API schema
Get user context
Fetch current user information and their relevant items (boards, folders, workspaces, dashboards). Use this tool at the beginning of conversations to: - Get context about who the current user is (id, name, title) - Discover user's favorite boards, folders, workspaces, and dashboards - Get user's most relevant boards based on visit frequency and recency - Reduce the need for search requests by knowing user's commonly accessed items
List users and teams
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.
List workspaces
List all workspaces available to the user. Returns up to 500 workspaces with their ID, name, and description.
Move object
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.
Read docs
Get a collection of monday.com documents with their content as markdown. PAGINATION: - Default limit is 25 documents per page - Use 'page' parameter to get additional pages (starts at 1) - Check response for 'has_more_pages' to know if you should continue paginating - If user asks for "all documents" and you get exactly 25 results, continue with page 2, 3, etc. FILTERING: Provide a type value and array of ids: - type: 'ids' for specific document IDs - type: 'object_ids' for specific document object IDs - type: 'workspace_ids' for all docs in specific workspaces - ids: array of ID strings (at least 1 required) Examples: - { type: 'ids', ids: ['123', '456'] } - { type: 'object_ids', ids: ['123'] } - { type: 'workspace_ids', ids: ['ws_101'] } USAGE PATTERNS: - For specific documents: use type 'ids' or 'object_ids' (A monday doc has two unique identifiers) - For workspace exploration: use type 'workspace_ids' with pagination - For large searches: start with page 1, then paginate if has_more_pages=true
Search
Search within monday.com platform. Can search for boards, documents, forms, folders. For users and teams, use list_users_and_teams tool. For workspaces, use list_workspaces tool. For items and groups, use get_board_items_page tool. For groups, use get_board_info tool. IMPORTANT: ids returned by this tool are prefixed with the type of the object (e.g doc-123, board-456, folder-789). When passing the ids to other tools, you need to remove the prefix and just pass the number.
Update folder
Update an existing folder in monday.com
Update form
Update a monday.com form. Handles the following form update actions that can only be done one at a time using the correct "action" input: - update form's feature settings with the action "updateFeatures", - update form's appearance settings with the action "updateAppearance", - update form's accessibility settings with the action "updateAccessibility", - update form's title with the action "updateFormHeader", - update form's description with the action "updateFormHeader", - update form's question order with the action "updateQuestionOrder", - create a new form tag with the action "createTag", - delete a form tag with the action "deleteTag", - update a form tag with the action "updateTag", - set or update the form's password with the action "setFormPassword" - shorten form's url with the action "shortenFormUrl" - deactivate form with the action "deactivateForm" - reactivate form with the action "activateForm"
Update workspace
Update an existing workspace in monday.com
Workspace info
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.
Frequently asked questions
What can I automate with Monday MCP on Definable?
Anything Monday MCP exposes through its API. Common productivity & project management workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 36 Monday MCP tools directly, then chain the result into another integration without you writing code.
How does Monday MCP authentication work?
Monday MCP uses DCR_OAUTH on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the Monday MCP integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 36 Monday MCP tools. You only need a separate Monday MCP subscription if Monday MCP itself charges per seat or per API call.
Is using Monday MCP through Definable secure?
Every call from a persona to Monday MCP is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with Monday MCP on Definable?
Sign up for Definable, open the integrations page, find Monday MCP, and connect via OAuth or API key. You can immediately attach Monday MCP to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What Monday MCP actions does Definable expose?
Definable exposes all 36 Monday MCP actions as callable tools — including `All monday api`, `All widgets schema`, `Board insights`, plus 33 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with Monday MCP?
Wire it up in minutes. No coding required.