npm package: @hachiai/mcp-monday-board
Description: MCP server for using the monday.com API
Latest version: 1.16.5

<div align="center" id="top">

# monday.com API MCP Server

</div>

A server implementation for the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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](https://developer.monday.com/api-reference/docs/authentication)

## ⚙️ Usage

```bash
npx @hachiai/mcp-monday-board@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

```bash
npx @hachiai/mcp-monday-board@latest -t abcd123 -m atp
```

### Cursor Integration (ATP Mode)

```json
{
  "mcpServers": {
    "mcp-monday-board": {
      "command": "npx",
      "args": [
        "@hachiai/mcp-monday-board@latest",
        "-t",
        "abcd123",
        "-m",
        "atp"
      ],
      "env": {
        "NODE_OPTIONS": "--no-node-snapshot"
      }
    }
  }
}
```

## 💻 Claude Desktop Integration

```json
{
  "mcpServers": {
    "mcp-monday-board": {
      "command": "npx",
      "args": [
        "@hachiai/mcp-monday-board@latest",
        "-t",
        "abcd123"
      ]
    }
  }
}
```

## 💻 Cursor Integration

### Using command line arguments

```json
{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest",
        "-t",
        "abcd123"
      ],
      "env": {}
    }
  }
}
```

### Using environment variable

```json
{
  "mcpServers": {
    "mcp-monday-board": {
      "command": "npx",
      "args": [
        "@hachiai/mcp-monday-board@latest"
      ],
      "env": {
        "monday_token": "abcd123"
      }
    }
  }
}
```

## License

This project is licensed under the MIT License - see the LICENSE file for details.