> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/en/advanced-features/integrations/mcp/aisuru-mcp-which-ones-and-how-to-activate/11.-monday.com-mcp-server.md).

# 11. Monday.com MCP Server

Monday.com works as a whiteboard where teams organize their work, their tasks, projects, deadlines, and ownership.

This MCP acts like an **assistant** that connects directly to the user’s Monday workspace and allows him to interact with it using **simple everyday language.** Meaning the user can simply just *talk* or *type* through the chat its  requests instead of going through the app manually.

This MCP is useful for:

* Creating and updating tasks in Monday
* Retrieving information about projects
* Automating work management

## Configuration parameters

| Parameter        | Required | Description                                                                              |
| ---------------- | -------- | ---------------------------------------------------------------------------------------- |
| `workspace_name` | No       | Name of the Monday.com workspace, used in the agent's instructions.                      |
| `api_key`        | Yes      | Your Monday.com API Key, used to authenticate with your account.                         |
| `token_param`    | No       | Name of the option used to pass the API key (default: `--token`). Rarely needs changing. |

### Custom parameters

* **apiVersion**: API version to use
* **timeout**: Maximum request time (seconds)
* **retries**: Retries in case of error
* **maxQueries**: GraphQL query complexity limit
* **resetInterval**: Complexity limit reset interval (seconds)

```json
{
  "apiVersion": "2024-01",
  "timeout": 60,
  "retries": 3,
  "complexity": {
    "maxQueries": 100,
    "resetInterval": 60
  }
}
```

## How to get the parameters <a href="#f09f9491-come-ottenere-i-parametri-4" id="f09f9491-come-ottenere-i-parametri-4"></a>

1. **After registering** and logging in to Monday
2. **Workspace Name**:
   * Look in the left sidebar
   * You'll see the current workspace name (e.g., "Main Workspace", "Marketing Team")
   * Use that exact name
3. **Api Key** (API Token):
   * Click your **profile photo** (bottom left)
   * Select **Admin** (if you're an admin) or **Developers**
   * In the side menu, go to **Developers** → **API Token**
   * Or go directly to: <https://monday.com/admin/integrations/api>
   * In the **"API Token"** section:
     * Click **"Generate"** to create a new token
     * Or **"Show"** to see an existing one
   * Copy the token (often starts with `eyJ...` , save the token securely!)
4. **Token Param**: default is --token, rarely needs changing
5. **Finding Workspace ID**:
   1. URL: `https://mycompany.monday.com/workspaces/12345678`
   2. The ID is `12345678`
6. **Board ID** (for reference):
   1. URL: `https://mycompany.monday.com/boards/123456789`
   2. The ID is `123456789`

### API Token security <a href="#f0-9f-94-92-sicurezza-api-token" id="f0-9f-94-92-sicurezza-api-token"></a>

* The API token has **the same permissions** as the user who generated it
* It can access all of that user's boards and workspaces
* Never share the token publicly
* Rotate the token periodically for security