> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect AI Agents to Monday.com Boards

> Let agents manage Monday.com boards, items, docs, and workspaces through the official OneCLI app. OAuth tokens are injected and never reach the agent.

## Overview

OneCLI connects AI agents to Monday.com through OAuth. Agents can read and manage boards, items, documents, workspaces, and more. The gateway injects OAuth credentials into requests to the Monday.com API automatically.

OneCLI is an official app on the [Monday.com marketplace](https://monday.com/marketplace). You connect through the OneCLI app, so you never create your own Monday.com developer app or copy API keys.

## What you will set up

* The OneCLI app installed in your Monday.com account by an admin
* A Monday.com connection through OAuth
* Per-agent access, with rules that match GraphQL operations

## Before you connect

Monday.com only lets an account use an app after an **account admin** has installed it. You install OneCLI once per Monday.com account. After that, everyone in the account can connect.

* **You're a Monday.com admin:** you don't need to do anything first. When you click **Connect Monday.com**, Monday.com asks you to install OneCLI, then brings you straight back to authorize it.
* **You're not an admin:** ask your admin to install OneCLI first. See [If you're not a Monday.com admin](#if-youre-not-a-mondaycom-admin).

> [!WARNING]
>
> When you install OneCLI, Monday.com asks which workspaces to install it on. Choose **all workspaces**, or every workspace your agents need to work in. OneCLI can only reach boards and docs in the workspaces you select here. You can change this later in Monday.com under **Administration** > **Apps**.

> [!TIP]
>
> Not sure if you're an admin? In Monday.com, click your profile picture in the top right. If you see **Administration** in the menu, you're an admin.

## Setup

**1. Open the app**

Open the OneCLI dashboard and navigate to **Settings** > **Apps** > **Monday.com**.

**2. Authorize**

Click **Connect Monday.com**. You'll be redirected to Monday.com. If OneCLI isn't installed in your account yet, an admin sees the install screen first. When Monday.com asks which workspaces to install OneCLI on, select **all workspaces** (or every workspace your agents need). Review the requested permissions and click **Authorize**.

![OneCLI connect window for Monday.com, with a note that only a monday.com account admin can install OneCLI and non-admins should ask theirs to install it from the marketplace, a How to get it installed link, and the Connect to monday.com button.](https://mintcdn.com/onecli-sh-docs/sLClq-IdqwxvWct5/images/integrations/monday/onecli-connect-monday.png?fit=max\&auto=format\&n=sLClq-IdqwxvWct5\&q=85\&s=ad5e1029cec401a4a669eb769d038a2c)

The Monday.com connect window in OneCLI.

![Monday.com Install OneCLI screen with All Workspaces selected, a Specific Workspaces option with a workspace picker, the permissions OneCLI requests, and the Install button.](https://mintcdn.com/onecli-sh-docs/sLClq-IdqwxvWct5/images/integrations/monday/monday-install-workspaces.png?fit=max\&auto=format\&n=sLClq-IdqwxvWct5\&q=85\&s=b0cc7182646cd874fe3dfcc543fe5b3f)

If OneCLI isn't installed yet, Monday.com shows its install screen first. Keep All Workspaces selected, or pick every workspace your agents need.

![Monday.com Authorize OneCLI screen listing permissions such as read your profile information, read account information, read and modify boards data, and read documents, with Cancel and Authorize buttons.](https://mintcdn.com/onecli-sh-docs/sLClq-IdqwxvWct5/images/integrations/monday/monday-authorize-onecli.png?fit=max\&auto=format\&n=sLClq-IdqwxvWct5\&q=85\&s=52cdb6d176064241746673aac9187dc9)

Monday.com asks you to authorize OneCLI and lists the permissions it requests.

**3. Verify**

After authorization, you'll be redirected back to the dashboard. The connection will show as **Connected** with your Monday.com account email.

## If you're not a Monday.com admin

If OneCLI isn't installed in your Monday.com account, Monday.com shows **App is not installed** and the **Authorize** button is disabled. You can't install it yourself, but you can ask your admin to do it in a few clicks.

**1. Ask your admin to install OneCLI**

Send your Monday.com admin this install link:

[Install OneCLI in Monday.com](https://auth.monday.com/oauth2/authorize?client_id=32e850d9793c50b04c800db4a434931e\&response_type=install)

Your admin opens it, chooses your account, selects **all workspaces** (or every workspace your agents need), and clicks **Install**. OneCLI only needs to be installed once per account.

You can also request it yourself from the Monday.com marketplace. Open the OneCLI app page and click **Request to add**. Every admin on your account gets the request by email and as a notification.

**2. Connect**

Once your admin has installed OneCLI, go back to **Settings** > **Apps** > **Monday.com** in OneCLI and click **Connect Monday.com**. The **Authorize** button now works.

> [!TIP]
>
> On Monday.com Enterprise, admins can let non-admins install apps through a custom role with **Access the Apps admin section** turned on.

## What agents can do

| Area | Description |
| - | - |
| **Boards** | View, create, and modify boards, items, columns, and groups |
| **Docs** | View, create, and edit Monday.com documents |
| **Updates** | View and post comments and updates on items |
| **Workspaces** | View and manage workspaces |
| **Users & Teams** | View user profiles and team info |
| **Tags & Assets** | View account tags and file assets |
| **Webhooks** | Manage webhook configurations |
| **Notifications** | Send user notifications |

## Use cases

* Project management agents that create and update board items based on incoming requests
* Standup bots that read board status and generate summaries
* Agents that sync Monday.com items with other project management tools
* Reporting agents that pull board data for analysis

## Self-hosted: use your own monday.com app

> [!NOTE]
>
> **Skip this section on OneCLI Cloud.** It's only for self-hosted OneCLI without `MONDAY_CLIENT_ID` and `MONDAY_CLIENT_SECRET` set, or if you want your own company name on monday.com's install screen.

> [accordion] 1. Create the monday.com app
>
> In monday.com, open your avatar > **Developers**, then select **Build app**. Name it and save.

> [accordion] 2. Add the scopes
>
> Open **OAuth & Permissions** > **Scopes** and tick:
>
> `me:read`, `account:read`, `users:read`, `teams:read`, `workspaces:read`, `workspaces:write`, `boards:read`, `boards:write`, `docs:read`, `docs:write`, `updates:read`, `updates:write`, `assets:read`, `tags:read`, `notifications:write`, `webhooks:write`
>
> ![monday.com Developer Center, OAuth & permissions, Scopes tab, with OneCLI's 16 scopes ticked and users:write, teams:write, and webhooks:read left unticked.](https://mintcdn.com/onecli-sh-docs/sLClq-IdqwxvWct5/images/integrations/monday/01-provider-scopes.png?fit=max\&auto=format\&n=sLClq-IdqwxvWct5\&q=85\&s=1dcafd4d8a5237616c7ae683a1dbab0f)
>
> The Scopes tab of your monday.com app with OneCLI's scopes ticked.

> [accordion] 3. Add the redirect URL
>
> In OneCLI, open **Settings** > **Apps** > **monday.com** > **Custom credentials** and copy the **Redirect URI**. In monday.com, open **OAuth & Permissions** > **Redirect URLs**, add it, and save.
>
> ![OneCLI Custom credentials card for monday.com with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.](https://mintcdn.com/onecli-sh-docs/sLClq-IdqwxvWct5/images/integrations/monday/onecli-custom-credentials-monday.png?fit=max\&auto=format\&n=sLClq-IdqwxvWct5\&q=85\&s=7f5582c7960fbbf99b12e6fb6b88d606)
>
> Copy the Redirect URI from Custom credentials in OneCLI.
>
> ![monday.com Developer Center, OAuth & permissions, Redirect URLs tab, with https://onecli.example.com/v1/apps/monday/callback.](https://mintcdn.com/onecli-sh-docs/sLClq-IdqwxvWct5/images/integrations/monday/02-provider-redirect.png?fit=max\&auto=format\&n=sLClq-IdqwxvWct5\&q=85\&s=bb8bec1a694b9cd91812f0ea041860a5)
>
> The Redirect URLs tab with the OneCLI Redirect URI.

> [accordion] 4. Connect with your app
>
> Open **Basic Information** and copy the **Client ID** and **Client Secret**. Paste both into **Settings** > **Apps** > **monday.com** > **Custom credentials**, select **Save credentials**, then **Connect** and install the app in monday.com.

## Controlling access

Access is per agent: [grant](/docs/guides/agent-access.md) the connection to each agent that needs it. For finer control, use organization [rules](/docs/guides/rules.md): Monday.com uses a GraphQL API (`api.monday.com/v2`), so path-based rules apply to that endpoint, and [conditions](/docs/guides/rules.md#conditions) match specific operations in the request body.

## FAQ

> [accordion] Do I need to be a Monday.com admin?
>
> An account admin must install the OneCLI app once. After that, everyone in the account can connect. See [If you're not a Monday.com admin](#if-youre-not-a-mondaycom-admin).

> [accordion] Why can't the agent see some boards?
>
> OneCLI only reaches workspaces selected when the app was installed. Reinstall and choose all workspaces, or the ones agents need.

> [accordion] Does the agent see my Monday.com token?
>
> No. The token stays in OneCLI, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] How do I block specific Monday.com operations?
>
> Monday.com uses one GraphQL endpoint, so use [rules](/docs/guides/rules.md) with [conditions](/docs/guides/rules.md#conditions) that match operations in the request body.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.