/ 目錄 / 演練場 / 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 → 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 issues

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 呼叫
get_board board_id 建立項目前——了解欄位類型 1 次呼叫
search_items board_id, filters 讀取流程的項目篩選 1 次呼叫(分頁)
create_item board_id, group_id, name, column_values 收件流程/新工作 1 次呼叫
update_item_columns item_id, column_values 狀態/負責人/日期變更 1 次呼叫
create_update item_id, body 在項目上留言 1 次呼叫

成本與限制

運行它的成本

API 配額
Monday 的 GraphQL 複雜度預算——大型查詢的費用可能高於簡單查詢
每次呼叫 Token 數
欄位或項目眾多的看板 token 較重;偏好使用較窄的欄位集
費用
免費方案支援 API;Pro+ 有更高的複雜度預算
提示
只拉取你需要的欄位(item.column_values[id IN [...]]);避免在 50 個以上欄位的看板上全選

安全

權限、密鑰、影響範圍

最小權限: boards:read boards:write(僅在需要寫入時)
憑證儲存: MONDAY_API_TOKEN 環境變數
資料出站: 僅連至 api.monday.com
切勿授予: 對聊天驅動的 agent 使用管理員 token——使用有限制的應用程式 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 的欄位類型不同;狀態語意較弱

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

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