> ## 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 Buckle app. OAuth tokens are injected and never reach the agent.

## Overview

Buckle 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.

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

## What you will set up

* The Buckle 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 Buckle 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 Buckle, then brings you straight back to authorize it.
* **You're not an admin:** ask your admin to install Buckle first. See [If you're not a Monday.com admin](#if-youre-not-a-mondaycom-admin).

> [!WARNING]
>
> When you install Buckle, Monday.com asks which workspaces to install it on. Choose **all workspaces**, or every workspace your agents need to work in. Buckle 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 Buckle dashboard and navigate to **Settings** > **Apps** > **Monday.com**.

**2. Authorize**

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

![Buckle connect window for Monday.com, with a note that only a monday.com account admin can install Buckle 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-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/monday/buckle-connect-monday.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=108daef15fa79b4659b8e0c8b8aab486)

The Monday.com connect window in Buckle.

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

If Buckle 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 Buckle 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-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/monday/monday-authorize-buckle.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=64f8755c4a32c60cae58d74358e4f145)

Monday.com asks you to authorize Buckle 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 Buckle 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 Buckle**

Send your Monday.com admin this install link:

[Install Buckle 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**. Buckle only needs to be installed once per account.

You can also request it yourself from the Monday.com marketplace. Open the Buckle 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 Buckle, go back to **Settings** > **Apps** > **Monday.com** in Buckle 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 Buckle Cloud.** It's only for self-hosted Buckle 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 Buckle's 16 scopes ticked and users:write, teams:write, and webhooks:read left unticked.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/monday/01-provider-scopes.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=1ede868e5d5603c2c986864a903dd654)
>
> The Scopes tab of your monday.com app with Buckle's scopes ticked.

> [accordion] 3. Add the redirect URL
>
> In Buckle, open **Settings** > **Apps** > **monday.com** > **Custom credentials** and copy the **Redirect URI**. In monday.com, open **OAuth & Permissions** > **Redirect URLs**, add it, and save.
>
> ![Buckle 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-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/monday/buckle-custom-credentials-monday.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=5449c926c409195245f1c044cda275e5)
>
> Copy the Redirect URI from Custom credentials in Buckle.
>
> ![monday.com Developer Center, OAuth & permissions, Redirect URLs tab, with https://buckle.example.com/v1/apps/monday/callback.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/monday/02-provider-redirect.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=229a38d3627b5007eaca0a795f13b2e7)
>
> The Redirect URLs tab with the Buckle 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 Buckle 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?
>
> Buckle 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 Buckle, 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.