monday-graphql-mcp
monday-graphql-mcp
monday.com GraphQL API를 기반으로 개발하는 개발자를 돕는 MCP 서버 — 쿼리 검증, 컬럼 값 형식, 오류 설명, 라이브 스키마 인트로스펙션, 코드 스캐폴딩을 모두 AI 어시스턴트에서 제공합니다.
도구
도구 | API 키 필요 | 설명 |
| 아니요 | 모든 컬럼 유형에 대한 정확한 읽기/쓰기 JSON 형식 |
| 아니요 | API 오류를 해석하고 수정 제안 제공 |
| 아니요 | 통합, 웹훅, OAuth, 앱을 위한 보일러플레이트 코드 |
| 선택 사항 | 구문 검사, 복잡도 추정, 린트 경고 |
| 예 | 키워드로 필터링 가능한 라이브 스키마 인트로스펙션 |
| 예 | API에 대해 쿼리 또는 뮤테이션 실행 |
Related MCP server: mcp-graphql-tools
설정
1. 설치 및 빌드
git clone <repo-url> monday-graphql-mcp
cd monday-graphql-mcp
npm install
npm run build2. Claude Code에 추가
mcpServers 아래의 ~/.claude/settings.json에 다음을 추가하세요:
{
"mcpServers": {
"monday-graphql-mcp": {
"command": "node",
"args": ["/path/to/monday-graphql-mcp/dist/index.js"],
"env": {
"MONDAY_API_KEY": "your_api_key_here"
}
}
}
}API 키 가져오기: monday.com → Avatar → Administration → API.
구성을 업데이트한 후 Claude Code를 다시 시작하세요.
3. 키 없이 사용
column_value_format, explain_error, scaffold는 API 키 없이 즉시 작동합니다.
사용 예시
컬럼 유형의 정확한 형식 가져오기
How do I write a people column value?
→ uses column_value_format({ column_type: "people" }){
"personsAndTeams": [{ "id": 12345678, "kind": "person" }]
}API 오류 해석하기
I'm getting "ColumnValueException: invalid value" — what's wrong?
→ uses explain_error({ error: "...", query: "..." })쿼리 실행 전 검증하기
query {
boards(ids: [123]) {
items_page(limit: 500) {
items {
id
name
column_values { id text value }
subitems { id name }
}
}
}
}→ validate_query flags:
- Estimated complexity: ~4200 (HIGH — likely to hit limits)
- limit: 500 is the hard cap, but combined with subitems + all column_values this is expensive
- Fetching all column_values without ids filter — add ids: ["col1"] to reduce complexity
- Fetching subitems + column_values together — consider two separate queries보일러플레이트 생성하기
Scaffold a TypeScript webhook listener for monday.com
→ uses scaffold({ type: "webhook-listener", language: "typescript" })스캐폴드 유형: api-client, webhook-listener, oauth-flow, integration, board-view, dashboard-widget
언어: typescript, javascript, python
라이브 스키마 가져오기
Show me the monday.com schema for item-related types
→ uses get_schema({ filter: "item" })쿼리 실행하기
query {
me {
id
name
email
}
}→ uses run_query({ query: "..." })지원되는 컬럼 유형
text · long_text · numbers · status · people · date · timeline · checkbox · dropdown · link · email · phone · rating · country · board_relation · dependency · tags · hour · week · world_clock · color_picker · location · formula · mirror · auto_number · creation_log · last_updated · item_id · vote · files · subtasks
개발
npm run dev # run with tsx (no build step)
npm run build # compile TypeScript to dist/
npm start # run compiled output서버는 MCP 프로토콜을 사용해 stdin/stdout으로 통신합니다. MCP 호스트(Claude Code, Claude Desktop 등)가 실행하도록 설계되어 있으며, 터미널에서 직접 실행하는 용도가 아닙니다.
Available Tools
6 toolscolumn_value_formatA
Returns the exact read and write JSON format for any monday.com column type. No API key required. Use this whenever you need to know how to read or write a column value.
Inputs: column_type (required).
explain_errorA
Explains a monday.com API error response in plain language and suggests a fix. Paste the error JSON or message. No API key required.
Inputs: error (required), query.
get_schemaA
Fetches the live monday.com GraphQL schema and returns type definitions, available queries, and mutations. Requires a monday.com API key.
Inputs: filter, api_key.
run_queryB
Executes a GraphQL query or mutation against the monday.com API and returns the result. Requires a monday.com API key.
Inputs: query (required), api_key, variables.
scaffoldA
Generates ready-to-use boilerplate code for monday.com integrations and apps. No API key required.
Inputs: type (required), language (required), description.
validate_queryA
Validates a monday.com GraphQL query: checks syntax, estimates complexity, and flags common pitfalls. Optionally validates against the live schema when an API key is provided.
Inputs: query (required), api_key.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct use case: schema retrieval, query execution, query validation, column formatting, error explanation, and scaffolding. There is minimal conceptual overlap between them, and the descriptions make the boundaries clear.
Most tools use a clear verb_noun pattern (get_schema, validate_query, run_query, explain_error, scaffold), but column_value_format deviates by being a noun phrase rather than an action-oriented name. This is a minor inconsistency and does not prevent readability.
Six tools is a well-scoped set. Each tool addresses a distinct part of the monday.com GraphQL development workflow, and none feel redundant or unnecessary.
The set covers the full developer workflow: retrieving schema, validating queries, executing queries, understanding column value formats, troubleshooting errors, and generating boilerplate code. Since run_query handles arbitrary GraphQL operations, there are no obvious dead ends.
Maintenance
Related MCP Connectors
Monday.com MCP — wraps the Monday.com GraphQL API (BYO API key)
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Connect AI assistants to Stellary projects, boards, documents, and governed agent workflows.
Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with Monday.com workspaces, allowing retrieval of board lists, board details, item content, and user information through the Monday.com API.4MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to execute GraphQL queries and retrieve schema information from any GraphQL endpoint.28MIT
- AlicenseBqualityCmaintenanceA lightweight MCP server that provides a focused set of tools for interacting with monday.com's GraphQL API, enabling users to manage boards, items, users, and updates from AI assistants.13MIT
- AlicenseNot gradedqualityDmaintenanceEnables LLM assistants to query Monday.com boards, groups, items, and columns via a cached SQLite-backed sync engine, minimizing API calls.MIT