/ 디렉터리 / 플레이그라운드 / monday.com
← 모든 서버 ↗ GitHub
● 공식 mondaycom 🔑 본인 키 필요

monday.com

제작: mondaycom · mondaycom/mcp

자연어로 monday.com 보드, 항목, 업데이트, 그룹을 관리하세요 — 작업을 생성하고, 상태를 변경하고, 보고서를 롤업하세요. 30번 클릭할 필요가 없습니다.

monday.com의 공식 MCP는 monday GraphQL API를 툴로 매핑합니다. 항목을 생성/업데이트하고, 열 값을 변경하고, 업데이트를 게시하고, 그룹 간에 이동하고, 필터로 보드를 쿼리하세요. 개인 토큰 또는 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 토큰 — 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 항목의 소유자를 표시하세요.✓ 복사됨
    → 명확한 4개 그룹 요약
  3. 스탠드업 포맷
    10줄 스탠드업 포맷: moved-to-Done (카운트), started-Working (카운트), 소유자 @-mentions이 있는 Stuck 항목, 오늘 마감 항목.✓ 복사됨
    → 복사-붙여넣기 가능한 다이제스트

결과: 30초 안에 Slack 또는 LINE에 붙여넣을 수 있는 스탠드업 다이제스트.

함정
  • updated_at로 필터링하면 열-값 변경과 서브항목 업데이트를 포함합니다 — 노이즈가 많습니다 — activity_logs 쿼리를 추가하고 상태 또는 소유자 변경만 필터링하세요
함께 쓰기: line-bot · ms-teams

CSV에서 보드로 500개 항목 일괄 가져오기

👤 사전 나열된 작업으로 새 프로젝트를 시작하는 PM ⏱ ~25 min intermediate

언제 쓸까: Google Sheet / CSV의 작업이 있고 올바른 열이 채워진 monday 보드에 있기를 원합니다.

사전 조건
  • 보드와 일치하는 열이 있는 CSV — 헤더 이름이 보드 열과 대략 일치해야 합니다: name, status, owner_email, date
흐름
  1. 대상 보드 스키마 검사
    보드 <id>를 설명하세요: 모든 열의 id, title, type, 허용값.✓ 복사됨
    → 열 카탈로그
  2. CSV를 column_values로 매핑
    내 CSV 헤더 [붙여넣기]를 고려하여 monday 열 ID로의 매핑을 생성하세요. 허용된 집합에 없는 상태가 있는 CSV 행을 플래그하세요.✓ 복사됨
    → 매핑 + 유효성 검사 보고서
  3. 배치로 항목 생성
    create_item + 매핑된 column_values를 사용하여 25개 배치로 이 항목들을 생성하세요. 3회 연속 호출 실패 시 중지하세요.✓ 복사됨
    → 모든 itemId; 행 번호와 함께 나열된 모든 실패

결과: 소유자, 상태, 마감일이 사전 입력된 보드의 모든 500개 항목.

함정
  • 열-값 JSON 형태는 열 유형에 따라 다릅니다 — 유효하지 않은 페이로드를 쉽게 보낼 수 있습니다 — 항상 열 유형을 먼저 가져오세요. 상태는 {label:'...'}, 날짜는 {date:'YYYY-MM-DD'}, 사람은 {personsAndTeams:[{id,kind}]}를 사용합니다
  • 속도 제한은 ~60개 항목/분에서 시작합니다 — 배치 간에 대기하세요. monday는 MCP가 표면화하는 429를 반환합니다 — 2초 일시 중지를 추가하세요
함께 쓰기: filesystem

모든 활성 항목에 AI 작성 상태 업데이트 게시

👤 모든 진행 중인 항목에 대한 서면 문맥을 원하는 Ops/PMO ⏱ ~30 min intermediate

언제 쓸까: 주말 — '작업 중' 항목이 자동으로 2줄 상태 업데이트를 받기를 원합니다.

흐름
  1. 활성 항목 찾기
    상태 = '작업 중'인 보드 <id>의 항목을 나열하세요. 이름, 소유자, 마지막 업데이트 텍스트를 포함하세요.✓ 복사됨
    → 진행 중인 항목
  2. 항목당 2줄 업데이트 초안 작성
    각 항목에 대해 last_update + 최근 열 변경을 기반으로 2문장 상태 업데이트 초안을 작성하세요. 중립적인 톤을 사용하세요.✓ 복사됨
    → 검토할 준비가 된 초안
  3. 승인 후 게시
    한 번에 3개의 초안을 보여주세요. '확인'이 되면 항목의 업데이트로 게시하세요.✓ 복사됨
    → 게시된 업데이트; itemId 확인됨

결과: 모든 활성 항목에는 이제 신선한 주말 노트가 있으며, 팀을 위한 바쁜 작업이 없습니다.

함정
  • 검토 없이 자동 게시하면 당신을 난처하게 할 수 있습니다(잘못된 문맥) — 최소한 첫 주 동안 항상 게시물을 인간 '확인'으로 제어하세요
함께 쓰기: github

10개의 프로젝트 보드에서 임원 포트폴리오 롤업 생성

👤 프로그램 관리자 / 스태프 최고 ⏱ ~30 min advanced

언제 쓸까: 주간 리더십 검토: 모든 프로젝트의 상태를 요약한 슬라이드 하나.

흐름
  1. 포트폴리오 열거
    'Engineering / Projects' 폴더의 보드를 나열하세요. 각각에 대해 상태별로 항목을 계산하세요.✓ 복사됨
    → 보드별 상태 분포
  2. 건강 점수 계산
    각 보드에 대해: health = 100 - 5*(stuck items) - 2*(overdue items). < 70을 빨강으로 플래그하세요.✓ 복사됨
    → Board → health + color
  3. 마크다운 보고서 생성
    한 화면의 마크다운 테이블을 생성하세요: Board | Health | Stuck | Overdue | Top risk. 건강 오름차순으로 정렬하세요.✓ 복사됨
    → 리더십 준비 테이블

결과: 한눈에 보는 포트폴리오 대시보드, 주간 반복 가능.

함정
  • 'Stuck'과 'overdue'의 의미는 보드마다 다릅니다 — 상태 열을 표준화하거나 구성 파일에 보드별 재정의를 유지하세요
함께 쓰기: notion

보드에서 오래된 항목 찾기 및 보관

👤 낡은 것에 지친 보드 소유자 ⏱ ~25 min intermediate

언제 쓸까: 보드가 1000개 이상의 항목으로 증가했으며 많은 항목이 수개월 동안 만져지지 않았습니다.

흐름
  1. 만져지지 않은 항목 찾기
    보드 <id>의 항목이 90일 이상 업데이트되지 않았고 상태 != Done입니다. 이름, 소유자, 마지막 업데이트 날짜를 나열하세요.✓ 복사됨
    → 오래된 목록
  2. 항목별로 결정
    한 번에 10개의 목록을 표시하세요. 각각에 대해: keep / archive / reassign. 항목당 한 글자를 말하겠습니다.✓ 복사됨
    → 분류 결정
  3. 보관/이동 실행
    적용: archive_item으로 'a' 항목을 보관하고, 'r' 항목을 소유자 <me>로 재할당하고, 'k'를 유지하세요.✓ 복사됨
    → 보드 정리됨; 변경 로그 저장됨

결과: 현실을 반영하는 보드, 무엇이 보관되었고 왜인지의 감사 로그.

함정
  • 보관된 항목은 보이지 않습니다. 나중에 후회하면 복원하기 어렵습니다 — 먼저 보드를 스냅샷으로 복제하거나 시험 실행을 위해 보관 대신 레이블을 사용하세요

Sentry 페이지 후 연결된 아티팩트가 있는 사건 항목 생성

👤 대기 중인 엔지니어 ⏱ ~15 min intermediate

언제 쓸까: 사건이 방금 종료되었습니다. 범위, 타임라인 및 소유자를 캡처하는 monday 항목을 원합니다.

흐름
  1. 아티팩트 수집
    Sentry에서 issue <id>를 가져오세요: title, first seen, users affected, resolving release. GitHub에서 수정한 PR을 가져오세요.✓ 복사됨
    → 아티팩트 번들
  2. monday 항목 생성
    'Incidents' 보드에서 create_item을 사용하여 name='<Sentry title>', status='Resolved', owner=me, date=today, description=아티팩트 링크를 포함한 자동 작성 사후 분석.✓ 복사됨
    → 반환된 itemId
  3. 타임라인을 업데이트로 게시
    해당 항목에 타임라인 업데이트를 게시하세요: detection time, deploy reverted at, root cause, followups.✓ 복사됨
    → 게시된 업데이트

결과: 사건 종료 후 5분 이내에 생성된 사후 분석 항목, 모든 것이 연결됨.

함정
  • 너무 긴 설명이 monday 형식을 깨뜨립니다 — 설명을 헤드라인으로 유지하세요. 세부 사항을 스레드 업데이트에 넣으세요
함께 쓰기: sentry · github

조합

다른 MCP와 조합해 10배 효율

monday + sentry

중요한 Sentry 문제가 발생할 때 monday 사건 항목 자동 생성

Sentry issue WEB-3a91이 100+ 이벤트에 도달하면 'Incidents' 보드에 항목을 생성하세요. name=issue title이고 severity 열이 P1로 설정되어 있습니다.✓ 복사됨
monday + github

PR 병합을 monday 항목 상태 변경에 연결

PR #342가 병합될 때 제목이 일치하는 monday 항목을 찾고 상태를 '완료'로 설정하세요.✓ 복사됨
monday + notion

주간 임원 포트폴리오 롤업이 Notion에 게시됨

포트폴리오 건강 롤업을 실행하고 결과가 테이블인 Notion 페이지를 생성하세요.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
list_boards workspace_id?, limit? 보드 검색 GraphQL 복잡도 단위
get_board board_id 쓰기 전 스키마 검사 복잡도
list_items board_id, limit?, cursor?, columns_filter? 페이징된 항목 가져오기 복잡도
create_item board_id, group_id?, name, column_values? 새 작업 추가 복잡도
change_column_value board_id, item_id, column_id, value 상태, 소유자, 날짜 등 업데이트 복잡도
create_update item_id, body 항목에 댓글 게시 복잡도
archive_item item_id 삭제하지 않고 제거 복잡도
create_webhook board_id, url, event 외부 시스템에 변경 사항 푸시 복잡도

비용 및 제한

운영 비용

API 쿼터
복잡도-예산 제한: Pro에서 분당 1000만 복잡도, Standard에서 500만. 무거운 쿼리는 더 비용이 많이 들습니다.
호출당 토큰
항목 읽기: 500–2000 토큰. 보드 스키마: 500–1500 토큰.
금액
API는 당신의 플랜 수준에서 무료입니다. monday 플랜은 ~$9/user/mo부터 시작합니다.
팁
list_items에서 columns 필터를 사용하여 필요한 필드만 반환하세요 — 넓은 보드에서 복잡도 상한을 피합니다.

보안

권한, 시크릿, 파급범위

최소 스코프: me:read boards:read
자격 증명 저장: 환경에서 MONDAY_API_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 write/sec로 백오프하세요. monday는 변경에 대한 분당 스로틀을 적용합니다.

대안

monday.com 다른 것과 비교

대안언제 쓰나단점/장점
Linear MCP엔지니어링 중심 팀이 키보드 우선 이슈 추적을 원할 때monday보다 유연성이 낮습니다. 임의 열 유형이 없습니다
Asana MCP팀이 Asana에 있을 때다른 열/필드 모델
Notion MCP한 곳에서 문서 + 가벼운 추적을 원할 때밀집 프로젝트 관리에서 더 약합니다. 진정한 PM 도구가 아닙니다

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기