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

# Setting Up Monday.com OAuth App

> Complete guide to creating and configuring a Monday.com OAuth application

## Prerequisites

* Monday.com account (admin access recommended)

## Step 1: Create a Monday App & Get Credentials

1. Log in to [Monday.com](https://monday.com)
2. Click your **avatar (top-right)** → **Developers**
3. In the Developer Console, click **Create App**
4. Once the app is created, you can immediately see the **Client ID** and **Client Secret**
5. Copy both and keep them safe

![Monday App Creation](https://mintcdn.com/klavisai/WUyJFoTOOKq1g0EB/images/knowledge-base/monday_oauth_app/monday_step1_create.png?fit=max\&auto=format\&n=WUyJFoTOOKq1g0EB\&q=85\&s=15180a7fa7ad5f3abf65ba7f50d86b31)

![Monday App Creation](https://mintcdn.com/klavisai/WUyJFoTOOKq1g0EB/images/knowledge-base/monday_oauth_app/monday_step1_cred.png?fit=max\&auto=format\&n=WUyJFoTOOKq1g0EB\&q=85\&s=c0be4f0f72ae8bce11ca511579311700)

> [!TIP]
>
> You now have your Monday.com **Client ID** and **Client Secret** ready for integration with Klavis AI.

## Step 2: Configure OAuth & Permissions

> [!NOTE]
>
> Klavis Monday MCP Server typically uses:
> `users:read, boards:read, boards:write, updates:write`

1. Open your app → go to **OAuth & Permissions**

2. Under **Scopes**, select the permissions your app requires.

![OAuth & Permissions](https://mintcdn.com/klavisai/WUyJFoTOOKq1g0EB/images/knowledge-base/monday_oauth_app/monday_step2_scope.png?fit=max\&auto=format\&n=WUyJFoTOOKq1g0EB\&q=85\&s=4ed5511628777840ce1e96f8371412f2)

3. Under **Redirect URLs**, add:

   ```
   https://api.klavis.ai/oauth/monday/callback
   ```

![OAuth & Permissions](https://mintcdn.com/klavisai/WUyJFoTOOKq1g0EB/images/knowledge-base/monday_oauth_app/monday_step2_redirect.png?fit=max\&auto=format\&n=WUyJFoTOOKq1g0EB\&q=85\&s=ff50af1bb839a7880c0d25245fd71db6)

## Step 3: Promote to Live

1. Once everything is set up, click **Promote to Live**.
   Your app will now have permanent credentials and can be used in production

![Promote to Live](https://mintcdn.com/klavisai/WUyJFoTOOKq1g0EB/images/knowledge-base/monday_oauth_app/monday_step3_live.png?fit=max\&auto=format\&n=WUyJFoTOOKq1g0EB\&q=85\&s=d38b05f419b3feaa386c5180e1cb5d84)

> [!TIP]
>
> You have successfully created Monday.com OAuth application! You now have your Client ID and Client Secret ready for integration with Klavis AI.

## (Optional) Step 4: White Labeling

> [!NOTE]
>
> White labeling lets you use your own Monday.com OAuth app branding instead of Klavis AI’s default.

To use your own OAuth app:

1. Go to [Klavis White Label Dashboard](https://www.klavis.ai/home/white-label)

2. Enter your **Monday Client ID** and **Client Secret** from Step 1

3. Confirm the redirect URI:

   ```
   https://api.klavis.ai/oauth/monday/callback
   ```

4. Start the OAuth flow with your client ID:

   ```javascript theme={null}
   const authUrl = `https://api.klavis.ai/oauth/monday/authorize?instance_id=${instanceId}&client_id=${yourClientId}`;
   ```

> [!TIP]
>
> For detailed examples, see our [OAuth & White Labeling guide](https://www.klavis.ai/docs/auth/white-label.md).

## Resources

* [Monday.com Docs](https://developer.monday.com/apps)
* [Klavis OAuth & White Labeling Guide](https://www.klavis.ai/docs/auth/white-label.md)
* [Klavis White Label Dashboard](https://www.klavis.ai/home/white-label)


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