Monday.com MCP

왜 쓰나요

핵심 기능

보드, 그룹, 항목, 컬럼 값, 업데이트 읽기
컬럼 인식 쓰기로 항목 생성 + 업데이트
더 안전한 에이전트 동작을 위한 워크스페이스 + 보드 탐색
서브아이템 지원
감사 추적을 위한 웹훅 + 활동 로그 접근

라이브 데모

실제 사용 모습

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 — Profile → Developer → API → API v2 token; MONDAY_API_TOKEN 환경 변수 설정

흐름

범위 탐색

Use monday-mcp. List my workspaces and the boards in 'Engineering' workspace.✓ 복사됨

→ 워크스페이스 + 보드 목록
보드별 진행 중인 항목 조회

For each engineering board, list items in 'Working on it' and 'Stuck' status with owner + due date.✓ 복사됨

→ 보드별 그룹화된 목록
롤업 작성

Write a Friday rollup: shipped this week, in flight, blocked. 6 bullets total.✓ 복사됨

→ 붙여넣기 준비된 간결한 롤업

결과: 45분이 아닌 5분 만에 크로스 보드 스냅샷.

함정

상태 컬럼 이름이 보드마다 다름 — Claude에게 상태 레이블 정규화 요청 (Stuck/Blocked → blocked); prompt에 매핑 문서화

함께 쓰기: google-workspace-mcp

인테이크 이메일/폼 데이터에서 항목 자동 생성

👤 인테이크 중심 운영 팀 ⏱ ~30 min intermediate

언제 쓸까: 고객이 폼/이메일로 제출하면 수동으로 Monday 항목을 생성할 때.

흐름

소스 파싱

Use google-workspace-mcp + monday-mcp. Read unread emails labeled 'intake', extract structured fields.✓ 복사됨

→ 이메일별 추출된 필드가 있는 JSON
항목 생성

For each, create an item on board 'Customer requests' with the right group + column values.✓ 복사됨

→ N개 항목이 퍼머링크와 함께 생성됨; 누락 정보 플래그 표시
답장/확인

Reply to each sender with the item link as ack.✓ 복사됨

→ 자동 응답 발송됨

결과: 몇 분 만에 처리된 인테이크; 모든 사람이 확인 응답을 받음.

함정

발신자 의도가 불분명해 항목이 잘못된 보드에 생성됨 — 확신이 낮으면 올바른 보드를 추측하지 말고 트리아지 그룹으로 라우팅

함께 쓰기: google-workspace-mcp

보드의 오래된 항목 정리

👤 좀비 카드에 지친 프로젝트 리더 ⏱ ~25 min intermediate

언제 쓸까: 장기 실행 보드의 분기별 위생 작업.

흐름

오래된 항목 식별

Use monday-mcp. List items on board 'Roadmap Q1' with no updates in 60+ days, grouped by owner.✓ 복사됨

→ 소유자별 오래된 항목 목록
소유자 알림 초안

Draft one Monday update per stale item, pinging the owner with: 'Still active? Move to done or archive.'✓ 복사됨

→ 업데이트 초안 준비됨
게시 + 유예 기간 후 대량 보관

Post the updates. After 7 days, anything still untouched gets moved to 'archive' group.✓ 복사됨

→ 업데이트 게시됨; 정리 작업을 위한 캘린더 항목 설정

결과: 과거의 희망이 아닌 현실을 반영하는 보드.

함정

실제로 작업 중인데 업데이트를 안 한 항목이 보관됨 — 항상 먼저 알림 발송; 자동 보관 전 유예 기간

조합

다른 MCP와 조합해 10배 효율

monday-mcp + google-workspace-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 이슈 동기화

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이 많이 소모됨; 좁은 컬럼 세트 선호
금액: 무료 티어는 API 지원; 더 높은 복잡도 예산은 Pro+ 필요
팁: 필요한 컬럼만 가져오기 (item.column_values[id IN [...]]); 컬럼이 50개 이상인 보드에서 전체 선택 피하기

보안

권한, 시크릿, 파급범위

최소 스코프: boards:read boards:write (only if writes needed)

자격 증명 저장: MONDAY_API_TOKEN 환경 변수

데이터 외부 송신: api.monday.com으로만

절대 부여 금지: 채팅 기반 에이전트에 관리자 token 금지 — 앱별 제한 token 사용

항목에 민감한 고객 데이터가 있을 수 있음 — Claude가 채팅 출력/로그에 옮기지 않도록 주의

문제 해결

자주 발생하는 오류와 해결

복잡도 예산 초과

쿼리당 컬럼/항목 수 줄이기; 한 번에 큰 호출 대신 페이지네이션

확인: Error includes 'complexity' phrasing

생성 시 잘못된 컬럼 유형

먼저 보드의 columns_schema 읽기; column_values는 유형별로 JSON 직렬화 필요

401 / token 유효하지 않음

Profile → Developer에서 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	엔지니어링 팀이 Monday가 아닌 Linear를 사용할 때	다른 제품; 두 시스템 간 매핑은 불완전
Notion MCP	업무 추적이 Notion 데이터베이스에 있을 때	Notion의 컬럼 유형이 다름; 1등급 상태 시맨틱 낮음