Skip to main content

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider’s consent screen.
  • Scopes: boards:read, boards:write.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration. These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

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. 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.

Provider notes

  • 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; OAuth tokens are sent as Authorization: Bearer <token>
  • Column values in mutations are passed as a JSON-encoded string
Provider API reference.

Tools

Verify the connection

Call a read tool such as monday__list_boards with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.