# monday.com

> Connect monday.com to FlyMyAI agents - boards, items, groups, columns, updates and users via OAuth.

Connects [monday.com](https://monday.com) to FlyMyAI agents via OAuth. Once
connected, an agent can read your boards, create and update items, manage
groups and columns, post updates and look up users - no token to paste.

## What it can do

| Method | What it does |
| --- | --- |
| `monday_get_boards` | List accessible boards (paginated) with id, name, state, owner and permissions. |
| `monday_get_board` | Get a single board by id with its groups, items, columns and metadata. |
| `monday_get_groups` | List groups (sections) in a board, paginated. |
| `monday_get_items` | List items (rows) in a board, optionally filtered by group, paginated. |
| `monday_get_item` | Get a single item with full details, column values and updates. |
| `monday_create_item` | Create a new item (row) in a board group, with optional column values. |
| `monday_update_item` | Update an existing item's column values. |
| `monday_delete_item` | Delete (archive) an item. |
| `monday_get_columns` | List columns in a board with id, title and type. |
| `monday_get_user` | Get the current user (viewer) - call first to verify auth and get the account id. |
| `monday_get_users` | List all workspace users, paginated. |
| `monday_get_teams` | List teams in the workspace. |
| `monday_get_workspace` | Get workspace metadata (account info and plan). |
| `monday_get_updates` | List updates (comments) on an item, paginated. |
| `monday_create_update` | Add an update (comment) to an item, with markdown support. |
| `monday_get_files` | List files attached to an item. |

The agent acts as the connected monday.com user and is bound by that user's
access. Confirm before creating, updating or deleting items, or posting updates.

## How to get credentials

monday.com uses OAuth - there's no token to copy.

1. In FlyMyAI, open the monday.com MCP and start the setup flow.
2. A monday.com authorization screen opens. Sign in with the account the agent
   should act as and approve access.
3. You're redirected back to FlyMyAI; the tool flips to **Configured**.

To revoke access later, in monday.com open **Admin → Apps** (or your profile's
connected apps) and remove FlyMyAI.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `MONDAY_ACCESS_TOKEN` | Stored automatically by the OAuth flow - nothing to paste. |
| `MONDAY_REFRESH_TOKEN` | Stored automatically by the OAuth flow - used to refresh access. |

No manual entry is needed - the OAuth flow stores the access and refresh tokens
for you. To switch accounts, remove the tool and reconnect.

## Troubleshooting

- **OAuth denied** - approve the FlyMyAI app on the monday.com consent screen; an
  account admin may need to allow third-party apps.
- **`401` after a while** - the access token expired; FlyMyAI refreshes it
  automatically, but if the refresh token was revoked, reconnect.
- **Missing board or item** - many calls need a numeric `board_id` or `item_id`;
  use `monday_get_boards` then `monday_get_items` to find them.

## Links

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