@mondaydotcomorg/monday-api-mcp

monday.com API MCP Server

A server implementation for the Model Context Protocol (MCP) that provides an interface to interact with monday.com API.

💻 Claude Desktop Demo

https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd

Prerequisites

Before running the MCP server, make sure you have:

• Node v20 or higher installed
• NPM v5.2.0 or higher installed
• monday.com API key

⚙️ Usage

npx @mondaydotcomorg/monday-api-mcp@latest -t abcd123

The monday.com API token can also be provided via the monday_token environment variable.

Command Line Arguments

Argument	Flags	Description	Required	Default
monday.com API Token	--token, -t	monday.com API token (can also be provided via monday_token environment variable)	Yes	-
API Version	--version, -v	monday.com API version	No	current
Read Only Mode	--read-only, -ro	Enable read-only mode	No	false
Mode	--mode, -m	Set the mode for tool selection: "api" - API tools only, "apps" - (Beta) Monday Apps tools only, "atp" - (Alpha) ATP server mode	No	api
Dynamic API Tools	--enable-dynamic-api-tools, -edat	(Beta) Enable dynamic API tools (Mode that includes the whole API schema, not supported when using read-only mode)	No	false

🧪 ATP Mode (Alpha)

ATP (Agent Tool Protocol) mode provides an alternative integration that enables GraphQL API exploration and code execution capabilities. This mode exposes two powerful tools:

• explore_api: Navigate and discover the monday.com GraphQL API structure
• execute_code: Execute JavaScript code to call monday.com APIs dynamically

⚠️ Alpha Feature: ATP mode is currently in alpha. APIs and behavior may change.

Usage

npx @mondaydotcomorg/monday-api-mcp@latest -t abcd123 -m atp

Cursor Integration (ATP Mode)

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest",
        "-t",
        "abcd123",
        "-m",
        "atp"
      ],
      "env": {
        "NODE_OPTIONS": "--no-node-snapshot"
      }
    }
  }
}

💻 Claude Desktop Integration

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest",
        "-t",
        "abcd123"
      ]
    }
  }
}

💻 Cursor Integration

Using command line arguments

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest",
        "-t",
        "abcd123"
      ],
      "env": {}
    }
  }
}

Using environment variable

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "monday_token": "abcd123"
      }
    }
  }
}

License

This project is licensed under the MIT License - see the LICENSE file for details.