<div align="center">

🚀 monday.com MCP

<p> <a href="https://npmjs.com/package/@mondaydotcomorg/monday-api-mcp"><img src="https://img.shields.io/npm/v/@mondaydotcomorg/monday-api-mcp.svg?style=flat" alt="npm 版本"></a> <a href="https://github.com/mondaycom/mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT 许可证"></a> <a href="https://github.com/mondaycom/mcp"><img src="https://img.shields.io/github/stars/mondaycom/mcp.svg?style=social" alt="GitHub Stars"></a> <img src="https://img.shields.io/badge/Node.js-v20+-green.svg" alt="Node.js 版本"> <img src="https://img.shields.io/badge/MCP-Compatible-blueviolet" alt="MCP 兼容"> <img src="https://img.shields.io/badge/Claude-Ready-orange" alt="Claude 就绪"> <img src="https://img.shields.io/badge/OpenAI-Compatible-lightgrey" alt="OpenAI 兼容"> <img src="https://img.shields.io/badge/TypeScript-Powered-blue" alt="TypeScript"> </p>

启用AI代理在实际工作流程中可靠运行。此MCP是monday.com的开放框架，用于将代理连接到您的工作操作系统中，赋予它们访问结构化数据的安全权限、执行操作的工具以及做出明智决策所需的上下文。

</div>

🌟 概述

这个由monday.com AI团队维护的仓库提供了一整套工具，供希望与monday.com集成的AI代理开发者使用。无论您是在构建AI助手、自动化程序还是自定义集成，我们的工具都能轻松地连接到monday.com平台。

👉 新手入门monday MCP？从这里开始：monday.com/w/mcp

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

🔑 什么是monday.com？

monday.com是一个工作操作系统，它帮助团队运行流程、项目和日常工作。团队使用monday.com在一个集中的平台上规划、跟踪和管理工作。它提供了一个视觉化的直观界面，团队可以：

• 使用可定制的看板创建和管理项目
• 通过状态列跟踪任务的不同阶段
• 通过更新和提及与团队成员协作
• 自动化工作流并与其他工具集成
• 使用仪表板和报告可视化数据

📦 内容概览

💻 monday API MCP服务器

@mondaydotcomorg/monday-api-mcp包提供了对模型上下文协议（MCP）的即插即用服务器实现。它允许AI代理无需构建复杂的集成即可与monday.com API交互。

🤖 代理工具包

@mondaydotcomorg/agent-toolkit包提供了一整套强大的工具和实用程序，用于构建与monday.com API交互的AI代理，支持OpenAI和模型上下文协议（MCP）的实现。

🚀 快速开始：托管MCP（推荐）

这是连接到monday.com最快、最强大且最可靠的方式。 我们的托管MCP服务为您处理所有基础设施——无需本地设置、自动更新和性能提升。

📚 集成指南

开始使用您喜欢的AI平台：

• 入门指南 - 第一次使用monday MCP？
• Claude集成 - 连接Claude桌面
• Cursor集成 - 集成Cursor IDE
• ChatGPT集成 - 连接ChatG
• MS Copilot集成 - 集成Microsoft Copilot Studio
• Mistral集成 - 连接Mistral AI的le Chat
• 现成提示 - 示例提示以快速开始

使用托管MCP快速设置

对于Cursor

只需将以下内容添加到您的MCP设置中：

{
  "mcpServers": {
    "monday-mcp": {
      "url": "https://mcp.monday.com/mcp"
    }
  }
}

为什么使用托管MCP？

• ✅ 无需本地安装 - 立即生效无需设置
• ✅ 自动更新 - 始终获得最新功能
• ✅ 更好的性能 - 优化的基础设施
• ✅ OAuth认证 - 安全令牌管理
• ✅ 工作区控制 - 限制特定工作区的访问
• ✅ 更高的可靠性 - 企业级正常运行时间

在什么情况下使用此仓库

如果您需要：

• 🔧 自定义MCP服务器 - 修改源代码以满足特定需求
• 🛠️ 构建自定义代理 - 使用代理工具包进行OpenAI或自定义实现
• 🔌 离线工作 - 在没有互联网连接的情况下开发
• 🧪 贡献开发 - 帮助改进MCP服务器或工具包

🏁 本地安装指南

步骤1：创建一个monday.com账户

如果您还没有monday.com账户：

1. 转到monday.com并注册一个账户
2. 创建您的第一个工作区和看板以开始使用

步骤2：生成API令牌

要与monday.com的API交互，您需要一个API令牌：

1. 登录您的monday.com账户
2. 单击左下角的头像
3. 选择“开发者”
4. 在左侧菜单中点击“我的访问令牌”
5. 复制您的个人访问令牌

步骤3：配置您的MCP客户端

对于Claude桌面

1. 打开Claude桌面
2. 转到设置 → MCP服务器
3. 添加一个新服务器，配置如下：

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

对于Gemini CLI

要开始使用Gemini CLI，您可以使用官方的Gemini CLI扩展来连接monday.com。

Gemini CLI扩展捆绑了monday.com MCP服务器与上下文文件和自定义命令，教Gemini如何使用monday.com工具进行强大的工作流。

要安装扩展，请在终端中运行以下命令：

gemini extensions install https://github.com/mondaycom/mcp

如果您更愿意直接使用MCP服务器而不使用扩展，可以使用以下命令添加：

gemini mcp add -t http monday https://mcp.monday.com/mcp

一旦安装了扩展或添加了MCP服务器，可以通过运行以下命令启动Gemini CLI：

gemini

然后，在Gemini CLI中运行以下命令以验证您的monday.com账户：

/mcp auth monday

这将打开一个浏览器窗口以完成身份验证过程。身份验证后，所有monday.com工具和自定义命令都将可用。

一些可用于扩展的自定义命令示例：

• /monday:create-item 在看板123中创建一个项目，内容为“更新UI”
• /monday:sprint-summary 获取冲刺853的摘要

对于Cursor或其他MCP客户端（本地设置）

添加到您的设置中：

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

步骤5：测试您的集成

1. 向Claude或其他AI助手提问，例如：

   • “我在看板123中有哪些项目？”
   • “你能创建一个看板来管理我的项目吗？”

2. 您的助手现在应该能够与您的monday.com账户互动！

⚙️ 高级托管MCP配置

使用授权头

要指定自定义授权头和API版本与托管MCP：

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "-p",
        "node@20",
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your_token>"
      }
    }
  }
}

指定API版本

您可以使用**--header**参数指定要使用的API版本：

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "mcp-
-remote", "https://mcp.monday.com/mcp", "--header", "Api-Version:${API_VERSION}" ], "env": { "API_VERSION": "2025-07" } } } }

安装Monday MCP应用

对于OAuth认证和工作区控制，从市场安装Monday MCP应用：

1. 访问市场上的Monday MCP应用
2. 点击“安装”并按照说明将其添加到您的账户

🧰 可用工具

我们的MCP服务器提供了一系列丰富的工具，使AI助手能够与monday.com互动：

类别	工具	描述
项目操作	create_item	在monday.com看板中创建具有指定列值的新项目
	delete_item	永久删除看板中的项目
	get_board_items_by_name	根据看板ID和术语/名称搜索项目
	create_update	在特定项目上添加更新/评论
	change_item_column_values	修改现有项目的列值
	move_item_to_group	将项目移动到同一看板内的不同组
看板操作	create_board	创建具有指定列的新monday.com看板
	get_board_schema	获取看板的列和组结构
	create_group	在monday.com看板中创建新组
	create_column	向现有看板添加新列
	delete_column	从看板中删除列
账户操作	list_users_and_teams	通过id、名称或搜索账户检索用户或团队的详细信息
工作表单操作	create_form	创建新的monday.com表单
	get_form	根据其令牌获取表单

🎨 monday.com应用框架工具

想要使用AI辅助构建自定义monday.com应用？应用框架工具为AI代理提供了对monday.com应用开发平台的完全访问权限，使您能够通过AI助手直接创建、管理和部署自定义应用。

📖 查看完整的应用框架工具文档

🔮 动态API工具（Beta）

我们的动态API工具特性代表了AI代理与monday.com交互方式的重大进步。虽然我们的标准工具涵盖了常见的操作，但动态API工具解锁了monday.com GraphQL API的全部潜力。

什么是动态API工具？

动态API工具为AI代理提供了对monday.com整个API表面的完全适应性访问。这意味着您的AI助手可以：

1. 访问任何API端点 - 不仅限于我们已经构建的预定义操作
2. 生成自定义GraphQL查询 - 创建适用于任何情况的确切查询
3. 动态探索monday.com的模式 - 了解所有可用的数据类型及其关系

关键动态API工具

工具	描述
all_monday_api	动态生成并执行任何GraphQL查询或突变
get_graphql_schema	获取monday.com的GraphQL模式以了解可用的操作
get_type_details	检索有关特定GraphQL类型的详细信息

解锁的可能性

有了动态API工具，您的AI助手可以：

• 创建复杂报告跨越多个看板、项目和数据点
• 执行批量操作同时跨许多项目
• 深度集成与monday.com的高级功能，如文档、工作区和活动日志
• 发现新功能随着monday.com向其API添加功能

如何启用

动态API工具处于测试阶段，默认情况下是禁用的。通过以下命令启用它们：

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

您还可以使用“仅”模式来独占启用动态API工具：

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

当启用“仅”模式时，服务器将仅提供动态API工具，过滤掉所有其他标准工具。这对于希望直接与GraphQL API交互的高级用户非常有用。

⚠️ 注意：动态API工具需要完整的API访问权限，并不兼容只读模式。

🖥️ MCP服务器配置

参数	标志	描述	是否必需	默认值
monday.com API令牌	--token, -t	monday.com API令牌	是	-
API版本	--version, -v	monday.com API版本	否	current
模式	--mode, -m	工具模式：default为标准平台工具，apps为应用框架工具	否	default
只读模式	--read-only, -ro	启用只读模式	否	false
动态API工具	--enable-dynamic-api-tools, -edat	启用动态API工具	否	false

🔐 认证与安全

服务器需要一个monday.com API令牌来与monday.com API进行认证。您可以通过以下两种方式提供此令牌：

1. 命令行参数：-t your_monday_api_token
2. 环境变量：monday_token=your_monday_api_token

安全最佳实践

• 永远不要在公共存储库或讨论中分享您的API令牌
• 考虑使用只读模式（--read-only），当您只需要检索数据时
• 定期轮换您的API令牌以增强安全性

📚 示例用例

这里是一些您可以使用我们的工具构建的例子：

1. 项目管理AI助手

• 在monday.com看板中创建和管理任务
• 获取项目状态更新
• 随着项目的进展在组之间移动项目

2. 数据分析与报告

• 从monday.com看板提取数据
• 生成报告和见解
• 为报告创建新的看板

🌐 社区与支持

• GitHub问题：用于报告错误和提出功能请求
• 讨论：用于问题和社区讨论
• monday.com开发者文档：了解更多关于monday.com API的信息

📚 文档

• monday API MCP文档
• 代理工具包文档
• monday.com API参考

📋 先决条件

在使用这些工具之前，请确保您已具备：

1. 安装了Node.js v20或更高版本
2. 安装了NPM v5.2.0或更高版本
3. 一个monday.com API令牌

🛠️ 如何在仓库中开发

要为仓库开发：

1. 克隆仓库
2. 安装依赖项：yarn install
3. 构建项目：yarn build
4. 复制monday-api-mcp包中dist/index.js文件的路径。
5. 更改配置以本地工作

    "monday-api-mcp": {
      "command": "node",
      "args": [
        "<your_full_path_to_the_package>/dist/index.js",
        "-t",
        "123",
        "--enable-dynamic-api-tools",