Skip to content

README.md

Latest commit

 

History

History
133 lines (103 loc) · 3.2 KB

README.md

File metadata and controls

133 lines (103 loc) · 3.2 KB

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

claude-mcp-demo.mov

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.