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

monday.com

作者 mondaycom · mondaycom/mcp

用自然语言管理 monday.com 的看板、任务项、更新和分组——创建任务、更改状态、汇总报告,告别频繁点击。

monday.com 官方 MCP 将 monday GraphQL API 映射为工具。创建/更新任务项、修改字段值、发布更新、跨分组移动、带过滤条件的看板查询。支持个人 token 或 OAuth;权限要设置得紧凑——写入权限可能重写整个看板。

为什么要用

核心特性

实时演示

实际使用效果

monday.replay ▶ 就绪
0/0

安装

选择你的客户端

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

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

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

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

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

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

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

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

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

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

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

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

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

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

使用场景

实战用法: monday.com

从项目看板自动生成每日站会摘要

👤 在 monday.com 上主持站会的团队负责人 ⏱ ~15 min beginner

何时使用: 你想要了解'昨天发生了什么、有什么卡住了、今天有什么到期',但不想手动滚动看板。

前置条件
  • monday API token — monday.com → avatar → Developers → My Access Tokens
  • 看板 ID — URL 包含 /boards/<board_id>
步骤
  1. 获取最近 24 小时更新的任务项
    列出看板 <id> 中 updated_at > yesterday 的任务项。显示名称、状态、负责人、截止日期。✓ 已复制
    → 最近活动列表
  2. 按状态分组
    按状态字段值分组:Done / Working / Stuck / To Do。显示数量以及每个 Stuck 项的负责人。✓ 已复制
    → 清晰的四象限总结
  3. 格式化站会内容
    生成一个 10 行的站会:moved-to-Done(数量)、started-Working(数量)、被卡住的项及其负责人、今天到期的项。✓ 已复制
    → 可复制粘贴的摘要

结果: 一份站会摘要,30 秒内可粘贴到 Slack 或 LINE。

注意事项
  • updated_at 过滤会包含字段值变更和子任务更新——信息过多 — 添加一个 activity_logs 查询,仅过滤状态或负责人的变更
搭配使用: line-bot · ms-teams

从 CSV 批量导入 500 个任务项到看板

👤 启动新项目、预先列出任务的产品经理 ⏱ ~25 min intermediate

何时使用: 你有一份 Google 表格或 CSV,想把这些任务导入 monday 看板并填好对应的字段。

前置条件
  • 与看板字段匹配的 CSV — 表头名称应大致匹配看板字段:name、status、owner_email、date
步骤
  1. 检查目标看板的结构
    描述看板 <id>:列出每个字段的 id、标题、类型和允许的值。✓ 已复制
    → 字段目录
  2. 将 CSV 映射到字段值
    给定我的 CSV 表头 [粘贴],生成到 monday 字段 id 的映射。标记任何不在允许值集合中的状态。✓ 已复制
    → 映射 + 验证报告
  3. 批量创建任务项
    用 create_item 和映射后的字段值,以 25 个为一批创建任务项。连续 3 次调用失败时停止。✓ 已复制
    → 所有 itemId;失败的项列出行号

结果: 看板上的所有 500 个项都预填了负责人、状态和截止日期。

注意事项
  • 不同字段类型的字段值 JSON 格式不同——容易发送无效数据 — 始终先获取字段类型;status 使用 {label:'...'},date 使用 {date:'YYYY-MM-DD'},people 使用 {personsAndTeams:[{id,kind}]}
  • 速率限制在约 60 个项/分钟时触发 — 批次间暂停;monday 会返回 429,MCP 会上浮——添加 2 秒的暂停
搭配使用: filesystem

在每个进行中的项上发布 AI 生成的状态更新

👤 运维/PMO,想要为每个进行中的项添加书面说明 ⏱ ~30 min intermediate

何时使用: 周末——你想让每个'进行中'的项都自动获得 2 行的状态更新。

步骤
  1. 找到进行中的项
    列出看板 <id> 中状态为'进行中'的项。包含名称、负责人、最后的更新文本。✓ 已复制
    → 进行中的项
  2. 为每个项起草一个 2 行的更新
    为每个项起草一个 2 句话的状态更新,基于最后的更新和最近的字段变更。使用中立的语气。✓ 已复制
    → 起稿准备好审核
  3. 批准后发布
    一次显示 3 个起稿。我说'确定'时,作为项的更新发布。✓ 已复制
    → 更新已发布;项 ID 已确认

结果: 每个进行中的项现在都有一个新的周末总结,团队无需手动操作。

注意事项
  • 未经审核就自动发布可能会让你尴尬(上下文错误) — 至少在第一周,始终在人工'确定'的基础上才发布
搭配使用: github

生成跨 10 个项目看板的高管投资组合汇总

👤 项目经理 / 幕僚长 ⏱ ~30 min advanced

何时使用: 周度领导力评审:一张幻灯片总结每个项目的健康状况。

步骤
  1. 列举投资组合
    列出'工程 / 项目'文件夹中的看板。对每个看板,按状态计数任务项。✓ 已复制
    → 每个看板的状态分布
  2. 计算健康分数
    对每个看板:健康分数 = 100 - 5*(被卡住的项数) - 2*(逾期项数)。小于 70 标记为红色。✓ 已复制
    → 看板 → 健康分数 + 颜色
  3. 生成 markdown 报告
    生成一个单屏幕 markdown 表格:看板 | 健康分数 | 被卡住 | 逾期 | 主要风险。按健康分数升序排列。✓ 已复制
    → 可供领导层查看的表格

结果: 一个一目了然的投资组合仪表板,可每周重复运行。

注意事项
  • '被卡住'和'逾期'的定义在不同看板中可能不同 — 标准化状态字段或在配置文件中保留每个看板的覆盖设置
搭配使用: notion

查找并归档看板中的过期项

👤 厌倦了看板杂乱的所有者 ⏱ ~25 min intermediate

何时使用: 看板增长到 1000+ 个项,许多项好几个月未被触及。

步骤
  1. 找到未触及的项
    看板 <id> 上超过 90 天未更新且状态不是完成的项。列出名称、负责人、最后更新日期。✓ 已复制
    → 过期项列表
  2. 逐项决策
    一次显示 10 个。对每个项:保留 / 归档 / 重新分配。我会为每个项说一个字母。✓ 已复制
    → 分类决策
  3. 执行归档/移动
    执行:用 archive_item 归档'a'项,将'r'项重新分配给我,保留'k'项。✓ 已复制
    → 看板已清理;变更日志已保存

结果: 一个反映现实的看板,包含归档内容和原因的审计日志。

注意事项
  • 归档项不可见;如果后悔很难恢复 — 先复制看板作为快照,或者在试运行时用标签代替归档

Sentry 告警后,创建带有链接工件的事件项

👤 值班工程师 ⏱ ~15 min intermediate

何时使用: 事件刚关闭;你想要一个 monday 项来记录范围、时间线和负责人。

步骤
  1. 收集工件
    从 Sentry 获取问题 <id>:标题、首次发现时间、受影响用户、解决版本。从 GitHub 获取修复的 PR。✓ 已复制
    → 工件包
  2. 创建 monday 项
    在'事件'看板上,用 create_item,name='<Sentry 标题>'、status='已解决'、owner=我、date=今天、description=自动生成的事后总结,包含工件链接。✓ 已复制
    → 返回了 itemId
  3. 发布时间线作为更新
    在该项上发布时间线更新:检测时间、部署回滚时间、根本原因、后续行动。✓ 已复制
    → 已发布更新

结果: 事件关闭后 5 分钟内创建的事后总结项,所有东西都已链接。

注意事项
  • 过长的描述会破坏 monday 的格式 — 描述保持简洁,只列标题;把细节放在线程化的更新中
搭配使用: sentry · github

组合

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

monday + sentry

当关键的 Sentry 问题触发时,自动创建一个 monday 事件项

当 Sentry 问题 WEB-3a91 达到 100+ 个事件时,在'事件'看板上创建一个项,name=问题标题,severity 字段设置为 P1。✓ 已复制
monday + github

将 PR 合并链接到 monday 项的状态变更

当 PR #342 合并时,找到匹配其标题的 monday 项并设置状态为'完成'。✓ 已复制
monday + notion

周度高管投资组合汇总发布到 Notion

运行投资组合健康汇总,并在 Notion 中创建一个包含结果表格的页面。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
list_boards workspace_id?, limit? 发现看板 GraphQL complexity units
get_board board_id 在写入前检查结构 complexity
list_items board_id, limit?, cursor?, columns_filter? 分页获取任务项 complexity
create_item board_id, group_id?, name, column_values? 添加新任务 complexity
change_column_value board_id, item_id, column_id, value 更新状态、负责人、日期等 complexity
create_update item_id, body 在项上发布评论 complexity
archive_item item_id 删除而不清除 complexity
create_webhook board_id, url, event 将变更推送到外部系统 complexity

成本与限制

运行它的成本

API 配额
复杂度预算限制:Pro 版本 1000 万复杂度/分钟;Standard 版本 500 万。重型查询成本更高。
每次调用 Token 数
项读取:500-2000 个 token。看板结构:500-1500 个 token。
费用
API 在你的计划级别是免费的。monday 计划从约 $9/用户/月开始。
提示
在 list_items 中使用 columns 过滤器以仅返回需要的字段——避免在宽看板上达到复杂度上限。

安全

权限、密钥、影响范围

最小权限: me:read boards:read
凭据存储: 在环境变量中的 MONDAY_API_TOKEN(个人 token)
数据出站: All calls to api.monday.com
切勿授予: 不要为仅读取特定看板的 MCP 授予 account:admin 权限

故障排查

常见错误与修复

401 Not Authenticated

MONDAY_API_TOKEN 缺失或过期。在 monday.com → Developers → My Access Tokens 重新生成。

验证: curl -H 'Authorization: $MONDAY_API_TOKEN' https://api.monday.com/v2 -d '{"query":"{ me { name } }"}'
ComplexityException — Max complexity reached

查询过重。减少 limit 或每个项获取更少的字段/子任务。

ColumnValueException — invalid column value

字段值 JSON 的形状不适合字段类型。先获取字段并检查其类型,然后相应地构建 JSON(status: {label},date: {date:'YYYY-MM-DD'})。

Rate limit exceeded (429)

降低到约 1 次写入/秒。monday 对变更执行每分钟的限制。

替代方案

monday.com 对比其他方案

替代方案何时用它替代权衡
Linear MCP工程团队想要键盘优先的问题追踪不如 monday 灵活;没有任意列类型
Asana MCP团队在用 Asana不同的字段/列模型
Notion MCP你想在一个界面上有文档 + 轻量级追踪在密集的项目管理中表现较弱;不是真正的 PM 工具

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

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