Monday.com MCP Server
The Monday.com MCP server lets your AI agents interact with your Monday.com workspace. Agents can browse workspaces, boards, and items, look up users and teams, create new boards and items, update column values, and post updates — all through the Monday.com GraphQL API.
Capabilities
| Tool | What It Does |
|---|---|
| Get current user | Retrieve the profile of the authenticated user |
| List users | List users in the Monday account |
| List teams | List teams in the Monday account |
| List workspaces | List workspaces visible to the authenticated user |
| List boards | List boards with filtering by workspace, kind, or state |
| Get board | Retrieve a specific board with its columns and groups |
| List board columns | List all columns defined on a board |
| List board groups | List all groups (sections) on a board |
| Create board | Create a new board in a workspace |
| List items | List items on a board with optional column value details |
| Get item | Retrieve a specific item by ID |
| Create item | Create a new item on a board |
| Change column values | Update multiple column values on an existing item |
| Create update | Post an update (comment) on an item |
OAuth Setup
The Monday.com MCP server uses OAuth to authenticate on behalf of each user. To enable this integration, you need to create a Monday app and provide the credentials to Devs.ai.
Step 1: Create a Monday App
- Go to the Monday.com Developers page and sign in.
- Click Create app.
- Enter a name (for example, "Devs AI") and select your Monday account.
Step 2: Configure OAuth
- In your app settings, go to OAuth & Permissions.
- Add the redirect URL provided by your Devs.ai platform administrator.
- Add the following Scopes:
| Scope | What It Enables |
|---|---|
me:read | Read the authenticated user's profile |
boards:read | Read boards, columns, groups, and items |
boards:write | Create boards, items, and update column values |
users:read | Read user profiles |
teams:read | Read team information |
workspaces:read | Read workspace information |
updates:write | Post updates (comments) on items |
- Click Save.
Step 3: Get Your Credentials
- In your app settings, go to Basic Information.
- Copy the Client ID and Client Secret.
Step 4: Configure in Devs.ai
- Navigate to Organization > Connectors in Devs.ai.
- Find the Monday.com template and click Enable.
- Select OAuth as the authentication type.
- Enter your Client ID and Client Secret from Step 3.
- Select the tools you want to make available.
- Click Save.
When a user first interacts with an agent connected to Monday.com, they will be prompted to authorize access to their Monday.com account.
OAuth Configuration Reference
| Field | Value |
|---|---|
| Authorization URL | https://auth.monday.com/oauth2/authorize |
| Token URL | https://auth.monday.com/oauth2/token |
| Scopes | me:read, boards:read, boards:write, users:read, teams:read, workspaces:read, updates:write |