# Monday

## Overview

Monday integration allows you to connect your personal Monday account to Suger so your workflows can access boards, workspaces, and user-level Monday data.

### Org-Level vs User-Level

> **User-Level Only**: Monday integration is configured per user. Each user authenticates with their own Monday account through OAuth.

## Create User Integration

### Authenticate

1. Navigate to Settings > Integrations > User Integrations
2. Click `Connect Monday.com Account` in the Monday section
3. You will be redirected to Monday to authorize access
4. Grant access to your Monday account
5. Return to Suger to confirm the connection

:::note
Each user connects their own Monday account. Suger stores the OAuth credential securely and does not support manual credential entry for this integration.
:::

## Suger AI Tools

When Monday.com is connected, the Suger AI agent can manage boards and work items through Suger's built-in tools (38 actions). Capabilities are grouped below.

> **User-level**: Tools run against the connected user's Monday.com account.

| Capability | What the agent can do |
|------------|-----------------------|
| **Boards** | Create, update, and duplicate boards (e.g. `create-board`, `duplicate-board`, `list-boards`) |
| **Items** | Manage items and subitems, the core work unit (e.g. `create-item`, `update-item`, `create-subitem`) |
| **Item lifecycle** | Move, archive, and delete items across groups and boards (e.g. `move-item-to-group`, `archive-item`) |
| **Columns** | Define board schema and set cell values (e.g. `create-column`, `change-column-value`) |
| **Groups** | Manage row groups within a board (e.g. `create-group`, `list-groups`) |
| **Updates, workspaces & users** | Post activity updates and read org structure (e.g. `create-update`, `list-workspaces`, `get-user`) |

## Edit Integration

Editing is not supported. Delete and reconnect if you need to switch to a different Monday account.

## Delete Integration

Deleting removes the stored Monday credential from Suger and immediately revokes Suger access to that connected account.

:::warning
Deleting the integration removes Suger access to Monday immediately. Reconnect the integration if you need to restore access later.
:::
