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

# monday.com

> Manage boards, items, and column values in monday.com work management

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `boards:read`, `boards:write`.
* **Docs**: [https://developer.monday.com/apps/docs/oauth](https://developer.monday.com/apps/docs/oauth)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable               | Required | Description                                                                                                              |
| ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| `MONDAY_CLIENT_ID`     | Yes      | monday.com OAuth Client ID (from your app in the Developer Center) [Docs](https://developer.monday.com/apps/docs/oauth). |
| `MONDAY_CLIENT_SECRET` | Yes      | monday.com OAuth Client Secret [Docs](https://developer.monday.com/apps/docs/oauth).                                     |

## Setup

1. **Create a monday.com app**: Sign in to monday.com (a free trial account works) and open the Developer Center via your avatar → Developers, or [https://developer.monday.com/apps/docs/the-developer-center](https://developer.monday.com/apps/docs/the-developer-center). Click Create App.
2. **Configure OAuth scopes and redirect URI**: In the app's OAuth section, enable the boards:read and boards:write scopes and add your redirect URI ending in /api/auth/monday/callback.
3. **Copy credentials**: Copy the Client ID and Client Secret from the app's Basic Information page into MONDAY\_CLIENT\_ID and MONDAY\_CLIENT\_SECRET.
4. **Verify access**: Connect your monday.com account and run the List Boards tool.

* monday.com OAuth access tokens do not expire and there are no refresh tokens; tokens stay valid until the user uninstalls the app
* The API is GraphQL-only at [https://api.monday.com/v2](https://api.monday.com/v2); OAuth tokens are sent as Authorization: Bearer \<token>
* Column values in mutations are passed as a JSON-encoded string

Provider API reference: [https://developer.monday.com/api-reference/docs/basics](https://developer.monday.com/api-reference/docs/basics)

## Tools

| Tool                 | Access | Description                                                     |
| -------------------- | ------ | --------------------------------------------------------------- |
| List Boards          | Read   | List boards in the monday.com account                           |
| List Items           | Read   | List items on a monday.com board with their column values       |
| Get Item             | Read   | Get a monday.com item by ID with its column values and updates  |
| Create Item          | Write  | Create a new item on a monday.com board                         |
| Update Column Values | Write  | Update one or more column values on an existing monday.com item |

## Example prompts

* List my monday.com boards and summarize the items on the most active one.
* Create a new item on a monday.com board with a name and status.
