mcp
monday.com 官方 MCP 服务器,让 AI 助手直接操控项目管理数据
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
monday.com 官方 MCP 服务器,让 AI 助手直接操控项目管理数据
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。

monday.com 工作操作系统 + AI 智能体集成中间件
想象一下:你每天在 monday.com 上管理项目、分配任务、追踪进度,但当你想让 AI 助手帮你完成这些操作时,却发现 AI 和 monday.com 之间隔着一堵墙——它们说着不同的语言,无法直接对话。monday.com MCP(Model Context Protocol Server)正是为解决这一痛点而生的开源项目。
这是一个由 monday.com 官方 AI 团队维护的 TypeScript 项目,通过 Model Context Protocol(MCP)这一新兴的 AI 交互协议,让主流 AI 助手(Claude、GPT、Cursor 等)能够直接读写 monday.com 的工作数据、操作项目管理流程。它不是一个简单的 API 封装,而是一套完整的工具生态,覆盖了项目管理、数据查询、表单创建、AI 应用开发等多个层次。
monday.com 是全球最受欢迎的工作操作系统之一,被超过 225 个国家和地区的团队用于项目管理、流程自动化和团队协作。其开放的 API 生态吸引了大量开发者构建集成,但 AI 助手与 monday.com 的深度结合,长期以来缺乏标准化方案。
2024 年,随着 Anthropic 推出 Model Context Protocol(MCP),monday.com 团队率先响应,发布了官方 MCP Server。这个协议的核心价值在于:它为 AI 助手与外部工具之间建立了一种"通用语言"——一次实现,即可被任何兼容 MCP 的 AI 客户端使用,无需为每个 AI 平台单独适配。
monday.com MCP 项目于 2025 年开源至 GitHub,迅速获得关注,目前已有 411 颗星、83 个 Fork,由 monday.com 官方 AI 团队持续维护更新。
monday.com MCP 采用了清晰的 monorepo 结构,使用 Turborepo 管理两个核心 npm 包:
这是项目的核心,遵循 MCP 协议实现了一个标准的 MCP Server。它基于 @modelcontextprotocol/sdk 构建,通过 stdio 或 HTTP(streamable-http / SSE)两种传输层与 AI 客户端通信。
入口文件 src/index.ts 展示了简洁的启动逻辑:解析命令行参数 → 初始化 MondayAgentToolkit → 连接 MCP 传输层。核心能力由 @mondaydotcomorg/agent-toolkit 提供,后者封装了所有 monday.com GraphQL API 调用的工具逻辑。
MCP 服务器支持两种运行模式:
这是更底层的工具库,同时支持 MCP 协议和 OpenAI SDK 两种调用方式。它的导出结构分为三层:
mcp:MCP 协议适配core:核心工具类(MondayAgentToolkit)openai:OpenAI Agents SDK 适配依赖中可以看到几个有趣的库:exceljs(处理 Excel 导出)、mammoth(Word 文档解析)、unpdf(PDF 解析),这些暗示该工具包不仅能操作 monday.com 原生数据,还能处理导入的外部文档——这是一个有深度的功能集成。
这是该项目最独特的功能模块。通过 get_graphql_schema 和 all_monday_api 两个工具,AI Agent 可以动态探索 monday.com 的完整 GraphQL Schema,并构造任意 GraphQL 查询。这意味着即使 monday.com API 有更新,AI 也能通过 Schema 自省发现新能力,而不需要等待 MCP Server 版本更新。
monday.com MCP 提供了两种截然不同的接入方式,对应不同的技术能力需求:
monday.com 官方提供了托管 MCP 端点 https://mcp.monday.com/mcp,支持 streamable-http 和 SSE 两种协议。用户只需在 AI 客户端(如 Claude Desktop、Cursor、ChatGPT)配置一段 JSON 即可连接,无需安装任何本地依赖。
这是目前最优雅的使用方式,适合非技术用户和大多数 AI 助手使用场景。托管服务还支持 OAuth 认证和 Workspace 级别的访问控制,安全性优于直接共享 API Token。
本地启动仅需一行命令:
npx @mondaydotcomorg/monday-api-mcp@latest --token YOUR_TOKEN
这种方式适合需要自定义 MCP Server 配置(如启用 Dynamic API Tools Beta 或 ATP 模式)的开发者。但该项目没有提供 Dockerfile 或 docker-compose,这意味着容器化部署需要用户自行处理。对于 Docker 重度用户来说,这是一个明显的缺失。
| 依赖项 | 版本要求 |
|---|---|
| Node.js | >= 20 |
| monday.com 账号 | 必须(有免费版可用) |
| monday.com API Token | 个人访问令牌,开发者后台生成 |
| GPU | 不需要 |
| RAM | 约 512MB 即可流畅运行 |
MCP Server 提供了一套完整的 monday.com 操作工具,按功能分为四大类:
事项操作:create_item、delete_item、get_board_items_by_name、create_update、change_item_column_values、move_item_to_group
看板操作:create_board、get_board_schema、create_group、create_column、delete_column
账号操作:list_users_and_teams
表单操作:create_form、get_form
Apps Framework 工具:支持 monday.com 自定义应用的 AI 开发辅助(get-app-development-context、create-app-feature、get-app-versions 等)
这套工具覆盖了 monday.com 日常使用中 90% 以上的操作场景。
从源码可以观察到几个特点:
zod schema 验证输入参数)agent-toolkit 使用 @graphql-codegen/cli 自动从 monday.com API Schema 生成 TypeScript 类型,提升开发效率并减少类型错误代码质量评分:78/100。工程化程度高,但缺少 Dockerfile 影响了容器化部署的便利性,Dynamic API Tools 仍处于 Beta 阶段。
monday.com MCP 的出现,反映了一个更大的趋势:AI Agent 正在从"对话工具"进化为"行动工具"。MCP 协议的出现,使得 AI 助手不再局限于回答问题,而是能够真正操控外部系统、执行真实世界的工作流程。
monday.com 作为全球头部项目管理平台,其 MCP Server 的发布为各行业的 AI 自动化提供了标杆案例。从项目经理用自然语言创建任务,到 AI Agent 自动生成项目周报,monday.com MCP 让这些场景成为可能。
该项目目前 Star 增速稳定,由 monday.com 官方团队维护,技术选型成熟,是一个值得关注的 AI×SaaS 集成案例。