MCP 服务器

monday MCP Server

README

🚀 monday.com MCP

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.

</div>

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

https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd

🔑 What is monday.com?

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.

🏁 Complete Installation Guide

Step 1: Create a monday.com Account

If you don't already have a monday.com account:

Go to monday.com and sign up for an account
Create your first workspace and board to get started

Step 2: Generate an API Token

To interact with monday.com's API, you'll need an API token:

Log in to your monday.com account
Click on your avatar in the bottom-left corner
Select "Developers"
Click "My access tokens" on the left menu
Copy your personal access token

Step 3: Configure Your MCP Client

For Claude Desktop

Open Claude Desktop
Go to Settings → MCP Servers
Add a new server with this configuration:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp",
        "-t",
        "your_monday_api_token"
      ]
    }
  }
}

For Cursor or Other MCP Clients

Add to your settings:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp",
        "-t",
        "your_monday_api_token"
      ],
      "env": {}
    }
  }
}

Step 5: Test Your Integration

Ask Claude or your AI assistant a question like:
- "What items do I have in board 123?"
- "Can you create a board to manage my project?"
Your assistant should now be able to interact with your monday.com 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_column	Add a new column to an existing board
	delete_column	Remove a column from a board
Account Operations	get_users_by_name	Retrieve user information by name or partial name

🔮 Dynamic API Tools (Beta)

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:

npx @mondaydotcomorg/monday-api-mcp -t your_token --enable-dynamic-api-tools true

⚠️ 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 API Token	`--token`, `-t`	monday.com API token	Yes	-
API Version	`--version`, `-v`	monday.com API version	No	`current`
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:

Command line argument: -t your_monday_api_token
Environment variable: monday_token=your_monday_api_token

Security Best Practices

Never share your API token in public repositories or discussions
Consider using read-only mode (--read-only) when you only need to retrieve data
Regularly rotate your API tokens for enhanced security

📚 Example Use Cases

Here are some examples of what you can build with our tools:

1. AI Assistant for Project Management

Create and manage tasks in monday.com boards
Get updates on project status
Move items between groups as they progress

2. Data Analysis & Reporting

Extract data from monday.com boards
Generate reports and insights
Create new boards for reporting

3. Automated Workflows

Create items based on external triggers
Update item statuses based on conditions
Link related items across boards

🌐 Community & Support

GitHub Issues: For bug reports and feature requests
Discussions: For questions and community discussions
monday.com Developer Documentation: Learn more about the monday.com API

📚 Documentation

📋 Prerequisites

Before using these tools, make sure you have:

Node.js v20 or higher installed
NPM v5.2.0 or higher installed
A monday.com API token

🤝 Contributing

We welcome contributions from the community! Whether it's fixing bugs, improving documentation, or adding new features, your help is appreciated.

Fork the repository
Create your feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -m 'Add some amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

<div align="center"> <p>Built with ❤️ by the monday.com AI Team</p> <p> <a href="https://monday.com">monday.com</a> | <a href="https://developer.monday.com">Developer Platform</a> | <a href="https://github.com/mondaycom/mcp">GitHub</a> </p> </div>