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
- 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.
- 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.
- Copy credentials: Copy the Client ID and Client Secret from the app’s Basic Information page into MONDAY_CLIENT_ID and MONDAY_CLIENT_SECRET.
- 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
Tools
Verify the connection
Call a read tool such asmonday__list_boards with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.