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

# monday.com

> Connect monday.com to CloudThinker for board review, stalled-work analysis, sprint reporting, and approval-gated item updates

Connect your monday.com account to let CloudThinker agents review boards, find work that stopped moving, read item discussions, and update items after you approve them.

monday.com uses **OAuth** through its hosted MCP server, so you do not create an API token or paste credentials into CloudThinker.

***

## Prerequisites

* A **monday.com account** that can see the boards you want CloudThinker to read.
* Permission to authorize CloudThinker through monday.com's OAuth flow.
* A CloudThinker workspace where monday.com is not already connected.

<Info>
  Agents see exactly what the authorizing account sees. A board that account cannot open stays invisible to CloudThinker.
</Info>

***

## Setup

<Steps>
  <Step title="Open CloudThinker">
    Navigate to **Connections → monday.com** in your CloudThinker workspace.
  </Step>

  <Step title="Start the OAuth flow">
    Click **Connect** to open monday.com's authorization page.
  </Step>

  <Step title="Authorize CloudThinker">
    Sign in to the monday.com account that can access the boards you want to use, then approve access.
  </Step>

  <Step title="Return to CloudThinker">
    After authorization, CloudThinker stores the OAuth tokens and shows a **Connected** status.
  </Step>
</Steps>

***

## Connection details

monday.com uses OAuth — there are no connection fields to enter manually. CloudThinker stores the tokens automatically after the authorization flow completes.

| Field            | Description                                                             |
| ---------------- | ----------------------------------------------------------------------- |
| **OAuth tokens** | Issued by monday.com and stored automatically; no manual entry required |

***

## Required permissions

CloudThinker inherits the monday.com access granted during OAuth.

* **Read operations** cover the workspaces, boards, items, updates, docs, users, teams, automations, and sprints the authorizing account can already open.
* **Write operations** — creating an item, changing an item's column values, and posting an update — need matching monday.com permission **and** explicit [approval](/guide/approval) in CloudThinker.

<Tip>
  Authorize with an account limited to the boards CloudThinker needs. monday.com's MCP server exposes no delete or archive tool, so anything an agent creates has to be removed in monday.com itself.
</Tip>

***

## Agent capabilities

Once connected, agents can:

| Capability            | Description                                                                             |
| --------------------- | --------------------------------------------------------------------------------------- |
| **Account discovery** | List workspaces, boards, users, and teams, and return the board ids other requests need |
| **Board review**      | Summarize a board's groups and columns, and how its work splits by status and owner     |
| **Stalled work**      | Find items that have not moved inside a date window, ranked oldest first                |
| **Item context**      | Read item updates, board activity, and monday docs before acting                        |
| **Sprint reporting**  | Read monday dev sprint boards, sprint metadata, and sprint summaries                    |
| **Item writes**       | Create an item, change column values, or post an update — each after explicit approval  |

### Verify the connection

```text theme={null}
@alex list my monday.com workspaces and boards
```

### Example prompts

```text theme={null}
@alex review the Tasks board on monday.com and #report how work splits by status and owner
@alex find monday.com items that have not moved in 14 days and #recommend what to chase first
@alex read the updates on the checkout bug item and summarize what is blocking it
```

***

## Troubleshooting

<Accordion title="OAuth flow does not complete">
  Your browser may be signed in to a different monday.com account. Sign in to the intended account and retry the connection flow in CloudThinker.
</Accordion>

<Accordion title="An agent reports a board as empty">
  monday.com answers an unknown, deleted, or invisible board id with an empty record rather than an error. Ask the agent to list your workspaces and boards first, then name the board from that list.
</Accordion>

<Accordion title="An agent cannot find a board you can see">
  The OAuth flow may have run under an account without access to that board. Reconnect with the account that can open it. Recently visited boards are not the full inventory — boards belong to a workspace, and an agent has to read the workspace to list them.
</Accordion>

<Accordion title="A sprint summary comes back unavailable">
  Sprint summaries need a monday dev board that carries the sprint summary column. Boards without it return no summary, so ask for sprint metadata or a board review instead.
</Accordion>

<Accordion title="An agent stops before changing an item">
  Item writes are approval-gated. Approve the pending action in CloudThinker, or check that the authorizing monday.com account has write permission on that board.
</Accordion>

***

## Security

* **Least privilege** — grant only the permissions the agents need for your use case; start read-only and widen later.
* **Read-only by default** — use read-only credentials unless you want agents to make changes through this connection.
* **Rotate credentials** — rotate keys and tokens on your normal schedule; CloudThinker picks up the new value when you update the connection.
* **Revoke on offboarding** — remove the credential at the provider when you delete a connection or a teammate leaves.

- **Approval for writes** — keep item creation, column changes, and updates approval-gated in CloudThinker.
- **No undo path** — monday.com exposes no delete or archive tool, so remove anything an agent created from monday.com directly.

***

## Related

<CardGroup cols={2}>
  <Card title="Atlassian Connection" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/atlassian.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=64fcf0381646a233832602a9086a14eb" href="/guide/connections/atlassian" width="24" height="24" data-path="images/icons/atlassian.svg">
    Jira and Confluence issue tracking and knowledge base
  </Card>

  <Card title="Approval" icon="shield-check" href="/guide/approval">
    How approval-gated actions work
  </Card>
</CardGroup>