Enable AI agents to operate reliably within real workflows. This MCP is monday.com's open framework for connecting agents into your work OS - giving them secure access to structured data, tools to take action, and the context needed to make smart decisions.
🌟 Overview
This repository, maintained by the monday.com AI team, provides a comprehensive set of tools for AI agent developers who want to integrate with monday.com. Whether you're building AI assistants, automations, or custom integrations, our tools make it easy to connect to the monday.com platform.
monday.com is a work operating system that powers teams to run processes, projects, and everyday work. Teams use monday.com to plan, track, and manage their work in one centralized platform. It provides a visual, intuitive interface where teams can:
Create and manage projects with customizable boards
Track tasks through different stages with status columns
Collaborate with team members through updates and mentions
Automate workflows and integrate with other tools
Visualize data with dashboards and reports
📦 What's Inside
💻 monday API MCP Server
The @mondaydotcomorg/monday-api-mcp package provides a plug-and-play server implementation for the Model Context Protocol (MCP). It allows AI agents to interact with the monday.com API without needing to build complex integrations.
🤖 Agent Toolkit
The @mondaydotcomorg/agent-toolkit package provides a powerful set of tools and utilities for building AI agents that interact with the monday.com API, supporting both OpenAI and Model Context Protocol (MCP) implementations.
🚀 Quick Start: Hosted MCP (Recommended)
The fastest, most robust, and reliable way to connect to monday.com. Our hosted MCP service handles all the infrastructure for you - no local setup, automatic updates, and improved performance.
The Gemini CLI extension bundles the monday.com MCP server with a context file
and custom commands that teaches Gemini how to use the monday.com tools for
powerful workflows.
To install the extension run the following command in your terminal:
Once you have either the extension installed or the MCP server added, start
Gemini CLI by running:
gemini
Then, authenticate with your monday.com account by running the following
command inside Gemini CLI:
/mcp auth monday
This will open a browser window to complete the authentication process.
After authenticating, all the monday.com tools and custom commands will
be available.
A few custom command to try out for the extension:
/monday:create-item create item in board 123 for "Update the UI"
/monday:sprint-summary sprint summary for sprint 853
Click "Install" and follow the instructions to add it to your account
🧰 Available Tools
Our MCP server provides a rich set of tools that give AI assistants the ability to interact with monday.com:
Category
Tool
Description
Item Operations
create_item
Create a new item in a monday.com board with specified column values
delete_item
Delete an item from a board permanently
get_board_items_by_name
Search for items by board ID and term/name
create_update
Add an update/comment to a specific item
change_item_column_values
Modify the column values of an existing item
move_item_to_group
Move an item to a different group within the same board
Board Operations
create_board
Create a new monday.com board with specified columns
get_board_schema
Retrieve the structure of columns and groups for a board
create_group
Create a new group in a monday.com board
create_column
Add a new column to an existing board
delete_column
Remove a column from a board
Account Operations
list_users_and_teams
Retrieve user or team's details by id, name or by searching the account
WorkForms Operations
create_form
Create a new monday.com form
get_form
Get a form by its token
🎨 monday.com Apps Framework Tools
Looking to build custom monday.com apps with AI assistance? The Apps Framework Tools provide AI agents with complete access to monday.com's app development platform, enabling you to create, manage, and deploy custom apps directly through AI assistants.
Our Dynamic API Tools feature represents a significant advancement in how AI agents can interact with monday.com. While our standard tools cover common operations, Dynamic API Tools unlock the full potential of the monday.com GraphQL API.
What are Dynamic API Tools?
Dynamic API Tools provide AI agents with complete, adaptable access to monday.com's entire API surface. This means your AI assistant can:
Access any API endpoint - Not just the predefined operations we've built
Generate custom GraphQL queries - Create exactly the query needed for any situation
Dynamically explore monday.com's schema - Understand all available data types and their relationships
Key Dynamic API Tools
Tool
Description
all_monday_api
Generate and execute any GraphQL query or mutation dynamically
get_graphql_schema
Fetch monday.com's GraphQL schema to understand available operations
get_type_details
Retrieve detailed information about specific GraphQL types
Unlocked Possibilities
With Dynamic API Tools, your AI assistants can:
Create complex reports spanning multiple boards, items, and data points
Perform batch operations across many items simultaneously
Integrate deeply with monday.com's advanced features like docs, workspaces, and activity logs
Discover new capabilities as monday.com adds features to their API
How to Enable
Dynamic API Tools are in beta and disabled by default. Enable them with:
You can also use the 'only' mode to exclusively enable Dynamic API Tools:
MONDAY_TOKEN=your_monday_api_token npx @mondaydotcomorg/monday-api-mcp@latest --enable-dynamic-api-tools only
When 'only' mode is enabled, the server will provide just the Dynamic API Tools, filtering out all other standard tools. This is useful for advanced users who want to work directly with the GraphQL API.
⚠️ Note: Dynamic API Tools require full API access and are not compatible with read-only mode.
🖥️ MCP Server Configuration
Argument
Flags
Description
Required
Default
monday.com API Token
--token, -t
monday.com API token
Yes
-
API Version
--version, -v
monday.com API version
No
current
Mode
--mode, -m
Tool mode: default for standard platform tools, apps for Apps Framework tools
No
default
Read Only Mode
--read-only, -ro
Enable read-only mode
No
false
Dynamic API Tools
--enable-dynamic-api-tools, -edat
Enable dynamic API tools
No
false
🔐 Authentication & Security
The server requires a monday.com API token to authenticate with the monday.com API. You can provide this token in two ways: