monday-graphql-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@monday-graphql-mcp How do I format a status column value?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
monday-graphql-mcp
An MCP server that helps developers build on the monday.com GraphQL API — query validation, column value formats, error explanations, live schema introspection, and code scaffolding, all from your AI assistant.
Tools
Tool | API Key Required | Description |
| No | Exact read/write JSON format for any column type |
| No | Decode API errors and get a fix suggestion |
| No | Boilerplate code for integrations, webhooks, OAuth, and apps |
| Optional | Syntax check, complexity estimate, and lint warnings |
| Yes | Live schema introspection, filterable by keyword |
| Yes | Execute a query or mutation against the API |
Related MCP server: mcp-graphql-tools
Setup
1. Install and build
git clone <repo-url> monday-graphql-mcp
cd monday-graphql-mcp
npm install
npm run build2. Add to Claude Code
Add this to your ~/.claude/settings.json under mcpServers:
{
"mcpServers": {
"monday-graphql-mcp": {
"command": "node",
"args": ["/path/to/monday-graphql-mcp/dist/index.js"],
"env": {
"MONDAY_API_KEY": "your_api_key_here"
}
}
}
}Get your API key: monday.com → Avatar → Administration → API.
Restart Claude Code after updating the config.
3. Use without a key
column_value_format, explain_error, and scaffold work immediately with no API key.
Usage Examples
Get the exact format for a column type
How do I write a people column value?
→ uses column_value_format({ column_type: "people" }){
"personsAndTeams": [{ "id": 12345678, "kind": "person" }]
}Decode an API error
I'm getting "ColumnValueException: invalid value" — what's wrong?
→ uses explain_error({ error: "...", query: "..." })Validate a query before running it
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 queriesGenerate boilerplate
Scaffold a TypeScript webhook listener for monday.com
→ uses scaffold({ type: "webhook-listener", language: "typescript" })Scaffold types: api-client, webhook-listener, oauth-flow, integration, board-view, dashboard-widget
Languages: typescript, javascript, python
Fetch the live schema
Show me the monday.com schema for item-related types
→ uses get_schema({ filter: "item" })Run a query
query {
me {
id
name
email
}
}→ uses run_query({ query: "..." })Supported Column Types
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
Development
npm run dev # run with tsx (no build step)
npm run build # compile TypeScript to dist/
npm start # run compiled outputThe server communicates over stdin/stdout using the MCP protocol — it's designed to be launched by an MCP host (Claude Code, Claude Desktop, etc.), not run directly in a terminal.
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.229 npm8MIT
- 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