/ 目录 / 演练场 / Monday.com MCP
● 官方 mondaycom 🔑 需要你的密钥

Monday.com MCP

作者 mondaycom · mondaycom/mcp

Monday.com 官方 MCP——通过 Claude 驱动你的看板、条目和仪表盘,具有结构化数据保障,而非屏幕爬取。

monday-mcp 通过官方 GraphQL API 将 Claude 连接到 Monday.com。读取看板/分组/条目,写入/更新条目和列值,并展示仪表盘。包含上下文工具,让 agent 在操作前了解工作区和看板的全貌——减少「看板选错」的错误。

为什么要用

核心特性

实时演示

实际使用效果

monday-mcp.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "monday-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "monday-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "monday-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "monday-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "monday-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "monday-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mondaydotcomorg/monday-api-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add monday-mcp -- npx -y @mondaydotcomorg/monday-api-mcp

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Monday.com MCP

汇总多个 Monday 看板的项目状态

👤 管理多看板项目的 PM 和团队负责人 ⏱ ~15 min beginner

何时使用: 周五汇报时需要扫描 5 个看板。

前置条件
  • Monday API token — 个人资料 → 开发者 → API → API v2 token;设置 MONDAY_API_TOKEN 环境变量
步骤
  1. 确定范围
    Use monday-mcp. List my workspaces and the boards in 'Engineering' workspace.✓ 已复制
    → 工作区和看板列表
  2. 拉取每个看板的活跃条目
    For each engineering board, list items in 'Working on it' and 'Stuck' status with owner + due date.✓ 已复制
    → 按看板分组的列表
  3. 撰写汇总
    Write a Friday rollup: shipped this week, in flight, blocked. 6 bullets total.✓ 已复制
    → 可直接粘贴的简洁汇总

结果: 5 分钟而非 45 分钟完成跨看板快照。

注意事项
  • 不同看板的状态列名称不同 — 让 Claude 统一标签(Stuck/Blocked → 已阻塞);在 prompt 中记录映射关系
搭配使用: google-workspace-mcp

从表单/邮件数据自动创建条目

👤 依赖表单驱动的运营团队 ⏱ ~30 min intermediate

何时使用: 客户提交表单/邮件后,你手动在 Monday 中创建条目。

步骤
  1. 解析来源
    Use google-workspace-mcp + monday-mcp. Read unread emails labeled 'intake', extract structured fields.✓ 已复制
    → 每封邮件提取的 JSON 字段
  2. 创建条目
    For each, create an item on board 'Customer requests' with the right group + column values.✓ 已复制
    → N 个条目已创建,附永久链接;缺失信息已标记
  3. 回复确认
    Reply to each sender with the item link as ack.✓ 已复制
    → 自动回复已发送

结果: 几分钟内处理完所有请求;每位发件人都收到确认。

注意事项
  • 发件人意图模糊;条目被放到了错误的看板 — 置信度低时路由到分类组,而非猜测正确看板
搭配使用: google-workspace-mcp

清理看板中的过期条目

👤 厌倦了僵尸卡片的项目负责人 ⏱ ~25 min intermediate

何时使用: 对长期运行看板进行季度清理。

步骤
  1. 识别过期条目
    Use monday-mcp. List items on board 'Roadmap Q1' with no updates in 60+ days, grouped by owner.✓ 已复制
    → 按负责人分组的过期列表
  2. 起草催促通知
    Draft one Monday update per stale item, pinging the owner with: 'Still active? Move to done or archive.'✓ 已复制
    → 更新草稿已准备好
  3. 发布通知 + 宽限期后批量归档
    Post the updates. After 7 days, anything still untouched gets moved to 'archive' group.✓ 已复制
    → 更新已发布;清理计划已设置日历提醒

结果: 看板反映真实状态,而非历史愿景。

注意事项
  • 归档了某人正在进行但未更新的条目 — 始终先发通知;自动归档前给予宽限期

组合

与其他 MCP 搭配,撬动十倍杠杆

从邮件创建条目;通过邮件确认;将状态摘要写入 Google Doc

From the 'intake' Gmail label, create Monday items, reply with the item link, and append a daily digest to a Google Doc.✓ 已复制
monday-mcp + github

同步工程 Monday 条目与 GitHub issue

When a Monday item moves to 'In review', add a GitHub issue link if missing; when GitHub issue closes, set Monday status to Done.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
list_boards workspace_id? 写入前始终调用——确定操作范围 1 GraphQL call
get_board board_id 创建条目前——了解列类型 1 call
search_items board_id, filters 读取流程中过滤条目 1 call (paged)
create_item board_id, group_id, name, column_values 新建请求 / 新工作 1 call
update_item_columns item_id, column_values 更新状态 / 负责人 / 日期 1 call
create_update item_id, body 在条目上发表评论 1 call

成本与限制

运行它的成本

API 配额
Monday 的 GraphQL 复杂度预算——大型查询比简单查询消耗更多
每次调用 Token 数
列数/条目数多的看板 token 消耗较大;优先使用窄列集
费用
免费版支持 API;较高复杂度预算需 Pro+ 计划
提示
只拉取你需要的列(item.column_values[id IN [...]]);避免对有 50+ 列的看板全选

安全

权限、密钥、影响范围

最小权限: boards:read boards:write (only if writes needed)
凭据存储: MONDAY_API_TOKEN 环境变量
数据出站: 仅发往 api.monday.com
切勿授予: 不要将管理员 token 提供给聊天驱动的 agent——使用权限受限的应用专用 token

故障排查

常见错误与修复

复杂度预算超限

减少每次查询的列数和条目数;使用分页分多次拉取,而非一次性大请求

验证: 错误信息中含 'complexity' 字样
创建时列类型错误

先读取看板的 columns_schema;column_values 必须按类型进行 JSON 序列化

401 / token 无效

在「个人资料 → 开发者」下重新生成 API token;token 为用户范围

验证: curl -X POST https://api.monday.com/v2 -H 'Authorization: $MONDAY_API_TOKEN' -d 'query{me{name}}'
子条目未显示在父条目下

子条目存在于独立的看板中;使用子条目的看板 ID,而非父条目的看板 ID

替代方案

Monday.com MCP 对比其他方案

替代方案何时用它替代权衡
Linear MCP工程团队使用 Linear 而非 Monday产品不同;两者之间的映射并不完美
Notion MCP你的工作跟踪在 Notion 数据库中Notion 的列类型不同;状态语义不如 Monday 原生

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills