Skip to main content
Glama
monday-graphql-mcp

monday-graphql-mcp

by ataliarf

monday-graphql-mcp

monday.com GraphQL API を使う開発者を支援する MCP サーバーです。クエリの検証、列値の形式、エラーの解説、ライブスキーマのイントロスペクション、コードのスキャフォールディングを、すべて AI アシスタントから実行できます。

ツール

ツール

APIキーの要否

説明

column_value_format

不要

任意の列タイプに対する正確な読み取り/書き込み JSON 形式を提供

explain_error

不要

API エラーをデコードし、修正案を取得する

scaffold

不要

インテグレーション、Webhook、OAuth、アプリ用のボイラープレートコードを生成

validate_query

任意

構文チェック、複雑性の見積もり、lint 警告を実行する

get_schema

あり

ライブスキーマのイントロスペクション。キーワードでフィルタリング可能

run_query

あり

API に対してクエリまたはミューテーションを実行する

Related MCP server: mcp-graphql-tools

セットアップ

1. インストールとビルド

git clone <repo-url> monday-graphql-mcp
cd monday-graphql-mcp
npm install
npm run build

2. 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 tools
column_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

    A3.9/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers