/ 目錄 / 演練場 / monday.com
● 官方 mondaycom 🔑 需要你的金鑰

monday.com

作者 mondaycom · mondaycom/mcp

用自然語言管理 monday.com 看板、項目、更新與群組 — 建立任務、變更狀態、彙整報告,不需要點擊 30 次。

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 → 頭像 → Developers → My Access Tokens
  • 看板 ID — URL 中包含 /boards/<board_id>
步驟
  1. 取得過去 24 小時更新的項目
    列出看板 <id> 中 updated_at > yesterday 的項目。顯示名稱、狀態、負責人、截止日期。✓ 已複製
    → 近期動態清單
  2. 依狀態分類
    依狀態欄位值將這些項目分組:Done / Working / Stuck / To Do。顯示各組數量及每個 Stuck 項目的負責人。✓ 已複製
    → 清晰的四分類摘要
  3. 格式化站立摘要
    格式化一份 10 行的站立摘要:移入 Done 的數量、開始 Working 的數量、Stuck 項目及負責人 @-mentions、今日到期項目。✓ 已複製
    → 可直接貼上的摘要文字

結果: 一份可在 30 秒內貼到 Slack 或 LINE 的站立摘要。

注意事項
  • updated_at 篩選會包含欄位值變更和子項目更新 — 雜訊較多 — 改用 activity_logs 查詢,並只篩選狀態或負責人的變更
搭配使用: line-bot · ms-teams

從 CSV 大量匯入 500 筆項目到看板

👤 要啟動新專案並已有任務清單的 PM ⏱ ~25 min intermediate

何時使用: 你有一份 Google 試算表 / CSV 格式的任務清單,想把它們匯入 monday 看板並填入正確的欄位。

前置條件
  • 欄位與看板相符的 CSV 檔案 — 標題名稱應大致對應看板欄位:name、status、owner_email、date
步驟
  1. 查看目標看板結構
    描述看板 <id>:列出每個欄位的 id、標題、類型及允許值。✓ 已複製
    → 欄位目錄
  2. 將 CSV 對應到 column_values
    根據我的 CSV 標題 [貼上],產生對應 monday 欄位 id 的映射。標記任何 CSV 列中不在允許集合內的狀態值。✓ 已複製
    → 映射關係 + 驗證報告
  3. 分批建立項目
    以每批 25 筆的方式,用 create_item 加上已映射的 column_values 建立這些項目。若連續 3 次呼叫失敗則停止。✓ 已複製
    → 所有 itemId;失敗項目及其列號

結果: 全部 500 筆項目上板,並預先填入負責人、狀態和截止日期。

注意事項
  • 不同欄位類型的 column_value JSON 格式各不相同 — 容易送出無效的 payload — 先取得欄位類型;status 用 {label:'...'},date 用 {date:'YYYY-MM-DD'},people 用 {personsAndTeams:[{id,kind}]}
  • 速率限制約每分鐘 60 筆 — 在批次之間暫停;monday 回傳 429 會由 MCP 顯示 — 加入 2 秒延遲
搭配使用: filesystem

對每個進行中的項目發布 AI 撰寫的狀態更新

👤 希望每個進行中項目都有書面說明的 Ops/PMO ⏱ ~30 min intermediate

何時使用: 週末 — 你希望每個「Working on it」狀態的項目都能自動收到一段 2 行的狀態更新。

步驟
  1. 找出進行中的項目
    列出看板 <id> 上狀態為「Working on it」的項目。包含名稱、負責人、最後更新文字。✓ 已複製
    → 進行中項目清單
  2. 為每個項目草擬 2 行更新
    針對每個項目,根據 last_update 和近期欄位變更,草擬一段 2 句的狀態更新。使用中性語氣。✓ 已複製
    → 草稿準備好供審閱
  3. 確認後發布
    每次顯示 3 個草稿。我說「ok」後,將其作為更新發布在該項目上。✓ 已複製
    → 更新已發布;已確認 itemId

結果: 每個進行中的項目都有最新的週末說明,團隊不需要做額外雜務。

注意事項
  • 未經審閱直接發布可能讓你難堪(上下文有誤) — 至少前一週請讓人工「ok」把關所有發布
搭配使用: github

跨 10 個專案看板產生主管層級的組合摘要

👤 計畫經理 / 幕僚長 ⏱ ~30 min advanced

何時使用: 每週領導層審查:一頁投影片總結所有專案的健康狀況。

步驟
  1. 列舉專案組合
    列出「Engineering / Projects」資料夾中的看板。對每個看板,依狀態統計項目數量。✓ 已複製
    → 各看板的狀態分布
  2. 計算健康分數
    對每個看板:健康分數 = 100 - 5*(stuck 項目數) - 2*(逾期項目數)。低於 70 標記為紅色。✓ 已複製
    → 看板 → 健康分數 + 顏色
  3. 產生 Markdown 報告
    產生一頁 Markdown 表格:看板 | 健康分數 | Stuck | 逾期 | 最高風險。依健康分數升冪排列。✓ 已複製
    → 供領導層使用的表格

結果: 一目了然的專案組合儀表板,每週可重複使用。

注意事項
  • 「Stuck」和「逾期」的定義在不同看板間可能不一致 — 統一狀態欄位,或在設定檔中保留各看板的覆寫設定
搭配使用: notion

找出並封存看板中的過時項目

👤 厭倦了看板雜亂的看板擁有者 ⏱ ~25 min intermediate

何時使用: 看板已成長到 1000 筆以上的項目,許多項目數月未被觸碰。

步驟
  1. 找出未更新的項目
    看板 <id> 上超過 90 天未更新且狀態不為 Done 的項目。列出名稱、負責人、最後更新日期。✓ 已複製
    → 過時項目清單
  2. 逐項決定處理方式
    每次顯示 10 個項目。對每個項目:保留 / 封存 / 轉派。我會對每個項目輸入一個字母。✓ 已複製
    → 分類決定
  3. 執行封存/移動
    套用操作:用 archive_item 封存「a」項目,將「r」項目轉派給負責人 <me>,保留「k」。✓ 已複製
    → 看板已整理;變更記錄已儲存

結果: 一個反映現實狀況的看板,並附有封存內容及原因的稽核記錄。

注意事項
  • 已封存的項目看不到;之後後悔了很難恢復 — 先複製看板作為快照備份,或先用標籤代替封存進行試運行

Sentry 告警後建立包含相關連結的事件項目

👤 值班工程師 ⏱ ~15 min intermediate

何時使用: 事件剛結束;你想在 monday 建立一個包含範圍、時間軸和負責人的項目。

步驟
  1. 收集相關資料
    從 Sentry 取得問題 <id>:標題、首次出現時間、影響使用者數、修復版本。從 GitHub 取得修復它的 PR。✓ 已複製
    → 資料包
  2. 建立 monday 項目
    在「Incidents」看板上,用 create_item 建立項目:name='<Sentry 標題>'、status='Resolved'、owner=我、date=今天、description=自動撰寫的事後分析(包含相關連結)。✓ 已複製
    → 已回傳 itemId
  3. 以更新形式發布時間軸
    在該項目上發布時間軸更新:偵測時間、回滾部署時間、根本原因、後續行動。✓ 已複製
    → 更新已發布

結果: 在事件結束 5 分鐘內建立一份事後分析項目,並連結所有相關資料。

注意事項
  • 過長的描述會破壞 monday 的格式排版 — 描述只保留重點;詳細內容放在串接的更新中
搭配使用: sentry · github

組合

與其他 MCP 搭配,撬動十倍槓桿

monday + sentry

當 Sentry 關鍵問題觸發時,自動建立 monday 事件項目

當 Sentry 問題 WEB-3a91 達到 100 次以上事件時,在「Incidents」看板上建立一個項目,name 為問題標題,severity 欄位設為 P1。✓ 已複製
monday + github

將 PR 合併與 monday 項目狀態變更連動

當 PR #342 合併時,找到標題相符的 monday 項目並將狀態設為「Done」。✓ 已複製
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)
資料出站: 所有呼叫皆傳送至 api.monday.com
切勿授予: account:admin for an MCP that only reads specific boards

故障排查

常見錯誤與修復

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 對 mutation 操作每分鐘有節流限制。

替代方案

monday.com 對比其他方案

替代方案何時用它替代權衡
Linear MCP工程導向的團隊想要以鍵盤為主的問題追蹤比 monday 彈性低;沒有任意欄位類型
Asana MCP團隊使用 Asana不同的欄位/屬性模型
Notion MCP你想要在同一個介面同時處理文件和輕量追蹤密集型專案管理能力較弱;不是真正的 PM 工具

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills