At a glance
- Availability: Experimental (how to enable).
- Auth: OAuth 2.0.
- Connection: A user authorizes the connection in the provider’s consent screen.
- Scopes:
boards:read,boards:write. - Docs: https://developer.monday.com/apps/docs/oauth
Credentials
Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.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.
- 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
| Tool | Access | Description |
|---|---|---|
| List Boards | Read | List boards in the monday.com account |
| List Items | Read | List items on a monday.com board with their column values |
| Get Item | Read | Get a monday.com item by ID with its column values and updates |
| Create Item | Write | Create a new item on a monday.com board |
| Update Column Values | Write | Update one or more column values on an existing monday.com item |
Example prompts
- List my monday.com boards and summarize the items on the most active one.
- Create a new item on a monday.com board with a name and status.