Monday.com (connect your real Monday.com account)
A first-party integration that connects Omniscio to your real Monday.com account through its Cloud API: view boards, manage items, track assigned work in your inbox, and react to item changes without leaving Omniscio. In development and off by default; connects with a personal API token rather than a sign-in.
On this page
What it is
Status: in development. Enable it in Settings → Features -> "Monday.com" (or set
AMC_SHOW_MONDAY_CLOUD=1); the "Monday.com" sidebar row appears once it is on.
What it is — A first-party Omniscio integration that connects
A first-party Omniscio integration that connects to your real Monday.com account
via its Cloud API so you can view boards, manage items, track assigned work in
your inbox, and trigger workflows from item changes; all without leaving Omniscio. It
surfaces as a "Monday.com" row in the projects sidebar (gated via the
monday-cloud unreleased-feature registry, default off).
This is NOT the existing Mission Control integration (id 'monday'), which is a
self-hosted project management system backed by its own database. The two
share no code. This integration (id 'monday-cloud') talks to the real
monday.com API.
Where to find it
Enable it in Settings → Features → Monday.com, after which a Monday.com row appears in the sidebar and the boards live behind it.
How it behaves
How to connect
- Enable it: Settings → Features -> toggle Monday.com on. A "Monday.com" row appears in the sidebar.
- Get your API token: go to monday.com -> click your avatar -> Developers -> My Access Tokens. Copy the token.
- Connect (in-panel): open the Monday.com sidebar row and click Set up Monday.com on the connect screen, then paste your API token in the drawer and Save — it tests the connection on save. (Monday.com uses the shared in-app connection stack — the same drawer as the Jira, Linear, Notion, and ClickUp boards — not a separate settings page.)
Your API token is encrypted at rest on your device (mondayCloudApiToken
is in ENCRYPTED_APP_SETTINGS_KEYS) and is never sent to the renderer.
Features
- Board view: see all your boards, groups rendered as swimlanes, items with inline column values
- Item detail: full item drawer with column values, updates/comments, and subitems
- Inline editing: change status, person, date, text columns directly — on the item AND on its subitems (each subitem edit is scoped to the subitem's own board)
- File columns: view a file column's attachments as download links, and upload a new file via a native picker (parent items)
- Search: find items across a board by column value
- Item creation: create new items in any group
- Move items: move items between groups
- Comments: post updates (comments) on items
- Inbox: items assigned to you appear in the unified inbox (enable "Monday.com Inbox" in settings); all assigned items surface as rows; updates re-fire the push
- Workflow triggers: fire automations when items are created, updated, or change status on a specific board
Limitations
- Personal API token only (no OAuth yet)
- Rate limited by Monday.com's complexity budget (approximately 3 req/s effective); the client logs the remaining budget but does not proactively throttle
- Subitems are editable in the item drawer (status/person/date/text columns), EXCEPT a subitem's own file columns, which are shown read-only (file upload targets parent items only)
- File/asset columns: view (download links) + upload (native picker) are supported on parent items; monday's relational column types (formula, mirror, dependency, connect-boards) are still not supported
- Column values are JSON-encoded strings in the API (must
JSON.stringifybefore sending)
Troubleshooting
Each message below is the exact copy the app shows.
- "Invalid API token. Generate a new one at monday.com → Admin → API." — the saved token was refused (a 401). Generate a new one and re-enter it.
- "Permission denied. Check your Monday.com API token permissions." — the token is valid but not allowed to do this (a 403); check its scopes in Monday.
- "Rate limit reached. Please wait a moment and try again." — Monday's complexity budget resets per minute; wait about a minute.
- "Monday.com is temporarily unavailable. Please try again later." — a Monday server error (5xx). Nothing was changed; retry later.
- "Monday.com could not process the request. Please try again or check that the board and item still exist." — Monday returned a GraphQL error; the board or item may have been renamed or deleted.
- "Could not connect to Monday.com. Check your network connection and try again." — the request never got an answer: offline, a proxy, or an outage.
- "Monday.com returned an unexpected response. Please try again." — the catch-all for any other status.
- A board is not showing — check the workspace filter in the sidebar.
- The feature is not visible —
mondayCloudEnabledis off; turn it on in Settings → Lab (or setAMC_SHOW_MONDAY_CLOUD=1).
Related
Related — mission-control.md
- mission-control.md: the built-in project management system (different feature, different code)
- Contract:
.claude/memory/contracts/monday-cloud-contract.md: the invariants and the tests that lock them
Last verified 2026-10-06