# monday.com [Official] [Health: Active]

**Category:** 📋 Product Management  
**Repository:** https://github.com/mondaycom/mcp  
**GitHub Stars:** 437  
**npm Downloads (last month):** 11210  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/monday-com

## Description
Enable AI agents to work reliably - giving them secure access to structured data, tools to take action, and the context needed to make smart decisions.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "monday-com": {
    "command": "npx",
    "args": ["-y","@mondaydotcomorg/monday-api-mcp@latest"],
    "env": {
      "MONDAY_TOKEN": "",
      "AUTH_HEADER": "",
      "API_VERSION": ""
    }
  }
}
```

**Requires environment variables:** `MONDAY_TOKEN`, `AUTH_HEADER`, `API_VERSION` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What monday.com MCP server does

The monday.com MCP server gives AI assistants an MCP interface to monday.com, a work operating system used for projects, processes, tasks, collaboration, and reporting. Agents can access structured workspace data and perform actions through the monday.com API rather than requiring a separate custom integration for each assistant.

The repository contains the `@mondaydotcomorg/monday-api-mcp` package, which runs the API-facing MCP server. It also includes `@mondaydotcomorg/agent-toolkit` for developers building agents that use monday.com through OpenAI or MCP implementations. The documented examples include asking for items on a board, creating a board, and creating an item with the Gemini CLI extension.

## How it works

Two deployment paths are documented. The hosted service is available at `https://mcp.monday.com/mcp` and can be added to compatible clients as an MCP URL. Hosted access uses OAuth authentication and is managed by monday.com, so clients do not need a local package installation. The hosted service also supports workspace access controls and an optional API-version header.

For local use, an MCP client launches the npm package with `npx`. The process communicates with monday.com using a personal API token supplied through the environment. This option is intended for source customization, custom agent development, offline development, or contribution work.

The monday.com MCP server is also available through an official Gemini CLI extension. The extension adds the server together with context instructions and custom commands, while Gemini CLI can alternatively connect directly to the hosted endpoint.

## Setup and configuration

The simplest hosted configuration points an MCP client at `https://mcp.monday.com/mcp`. Cursor’s documented configuration uses this URL directly. Gemini CLI can install the repository extension or add the hosted server with `gemini mcp add`, then authenticate with `/mcp auth monday`.

A local setup requires a monday.com account, a workspace and board, Node.js 20 or later, and a personal access token. Configure the client to run `npx @mondaydotcomorg/monday-api-mcp@latest` and provide the token as `MONDAY_TOKEN`.

Hosted connections can also be configured through `mcp-remote` with an `Authorization` header. An `Api-Version` header may be supplied when a specific monday.com API version is needed.

## Tools and capabilities

The available interface is designed for agents that need to work with monday.com data and workflows. Supported use described in the repository includes:

- Reading items from a specified board.
- Creating boards for project or process management.
- Creating items on a board.
- Accessing monday.com’s structured work data through MCP tools.
- Building custom agent workflows with the agent toolkit.
- Using Gemini CLI commands such as board-item creation and sprint summaries through the extension.

The exact tool catalog is provided by the running package or hosted service and may change as the service is updated.

## Limitations and notes

The hosted and local configurations are different deployment choices. Hosted MCP avoids local installation and receives service updates automatically, while local execution gives developers access to the repository and package for customization. Local API access depends on a valid monday.com token and network access to the monday.com API unless the surrounding development workflow is otherwise configured.

The repository documents integrations for Claude Desktop, Cursor, Gemini CLI, ChatGPT, Microsoft Copilot Studio, and Mistral’s le Chat through separate guides or extension support. Only clients with MCP support and an appropriate connection method can use the server directly. Keep API tokens and authorization values in client configuration or environment management rather than exposing them in prompts.

_Full upstream README: https://allmcps.com/mcp/monday-com/readme_