monday-graphql-mcp
monday-graphql-mcp
monday.com GraphQL API を使う開発者を支援する MCP サーバーです。クエリの検証、列値の形式、エラーの解説、ライブスキーマのイントロスペクション、コードのスキャフォールディングを、すべて AI アシスタントから実行できます。
ツール
ツール | APIキーの要否 | 説明 |
| 不要 | 任意の列タイプに対する正確な読み取り/書き込み JSON 形式を提供 |
| 不要 | API エラーをデコードし、修正案を取得する |
| 不要 | インテグレーション、Webhook、OAuth、アプリ用のボイラープレートコードを生成 |
| 任意 | 構文チェック、複雑性の見積もり、lint 警告を実行する |
| あり | ライブスキーマのイントロスペクション。キーワードでフィルタリング可能 |
| あり | 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 に追加
この内容を ~/.claude/settings.json の mcpServers に追加します:
{
"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.
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.
Query your app's logs, metrics and incidents from your AI assistant.
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