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:

1. Node v20 or higher installed
2. NPM v5.2.0 or higher installed
3. 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.