Monday.com API integration with managed OAuth. Manage boards, items, columns, groups, and workspaces using GraphQL. Use this skill when users want to create, update, or query Monday.com boards and ite
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Access the Monday.com API with managed OAuth authentication. Manage boards, items, columns, groups, users, and workspaces using GraphQL.
# Get current user python <<'EOF' import urllib.request, os, json data = json.dumps({'query': '{ me { id name email } }'}).encode() req = urllib.request.Request('https://gateway.maton.ai/monday/v2', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
https://gateway.maton.ai/monday/v2
All requests use POST to the GraphQL endpoint. The gateway proxies requests to
api.monday.comAll requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as
MATON_API_KEYexport MATON_API_KEY="YOUR_API_KEY"
Manage your Monday.com OAuth connections at
https://ctrl.maton.aipython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=monday&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'monday'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
Response:
{ "connection": { "connection_id": "ca93f2c5-5126-4360-b293-4f05f7bb6c8c", "status": "ACTIVE", "creation_time": "2026-02-05T20:10:47.585047Z", "last_updated_time": "2026-02-05T20:11:12.357011Z", "url": "https://connect.maton.ai/?session_token=...", "app": "monday", "metadata": {} } }
Open the returned
urlpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If you have multiple Monday.com connections, specify which one to use with the
Maton-Connectionpython <<'EOF' import urllib.request, os, json data = json.dumps({'query': '{ me { id name } }'}).encode() req = urllib.request.Request('https://gateway.maton.ai/monday/v2', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') req.add_header('Maton-Connection', 'ca93f2c5-5126-4360-b293-4f05f7bb6c8c') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If omitted, the gateway uses the default (oldest) active connection.
Monday.com uses a GraphQL API. All operations are sent as POST requests with a JSON body containing the
queryPOST /monday/v2 Content-Type: application/json{"query": "{ me { id name email } }"}
Response:
{ "data": { "me": { "id": "72989582", "name": "Chris", "email": "chris.kim.2332@gmail.com" } } }
POST /monday/v2 Content-Type: application/json{"query": "{ users(limit: 20) { id name email } }"}
POST /monday/v2 Content-Type: application/json{"query": "{ workspaces(limit: 10) { id name kind } }"}
Response:
{ "data": { "workspaces": [ { "id": "10136488", "name": "Main workspace", "kind": "open" } ] } }
POST /monday/v2 Content-Type: application/json{"query": "{ boards(limit: 10) { id name state board_kind workspace { id name } } }"}
Response:
{ "data": { "boards": [ { "id": "8614733398", "name": "Welcome to your developer account", "state": "active", "board_kind": "public", "workspace": { "id": "10136488", "name": "Main workspace" } } ] } }
POST /monday/v2 Content-Type: application/json{"query": "{ boards(ids: [BOARD_ID]) { id name columns { id title type } groups { id title } items_page(limit: 20) { cursor items { id name state } } } }"}
POST /monday/v2 Content-Type: application/json{"query": "mutation { create_board(board_name: "New Board", board_kind: public) { id name } }"}
Response:
{ "data": { "create_board": { "id": "18398921201", "name": "New Board" } } }
POST /monday/v2 Content-Type: application/json{"query": "mutation { update_board(board_id: BOARD_ID, board_attribute: description, new_value: "Board description") }"}
POST /monday/v2 Content-Type: application/json{"query": "mutation { delete_board(board_id: BOARD_ID) { id } }"}
POST /monday/v2 Content-Type: application/json{"query": "{ items(ids: [ITEM_ID]) { id name created_at updated_at state board { id name } group { id title } column_values { id text value } } }"}
Response:
{ "data": { "items": [ { "id": "11200791874", "name": "Test item", "created_at": "2026-02-05T20:12:42Z", "updated_at": "2026-02-05T20:12:42Z", "state": "active", "board": { "id": "8614733398", "name": "Welcome to your developer account" }, "group": { "id": "topics", "title": "Group Title" } } ] } }
POST /monday/v2 Content-Type: application/json{"query": "mutation { create_item(board_id: BOARD_ID, group_id: "GROUP_ID", item_name: "New item") { id name } }"}
POST /monday/v2 Content-Type: application/json{"query": "mutation { create_item(board_id: BOARD_ID, group_id: "GROUP_ID", item_name: "New task", column_values: "{\"status\": {\"label\": \"Working on it\"}}") { id name column_values { id text } } }"}
POST /monday/v2 Content-Type: application/json{"query": "mutation { change_simple_column_value(board_id: BOARD_ID, item_id: ITEM_ID, column_id: "name", value: "Updated name") { id name } }"}
POST /monday/v2 Content-Type: application/json{"query": "mutation { change_column_value(board_id: BOARD_ID, item_id: ITEM_ID, column_id: "status", value: "{\"label\": \"Done\"}") { id name } }"}
POST /monday/v2 Content-Type: application/json{"query": "mutation { delete_item(item_id: ITEM_ID) { id } }"}
POST /monday/v2 Content-Type: application/json{"query": "mutation { create_column(board_id: BOARD_ID, title: "Status", column_type: status) { id title type } }"}
Response:
{ "data": { "create_column": { "id": "color_mm09e48w", "title": "Status", "type": "status" } } }
Common column types:
statustextnumbersdatepeopledropdowncheckboxemailphonelinktimelinetagsratingPOST /monday/v2 Content-Type: application/json{"query": "mutation { create_group(board_id: BOARD_ID, group_name: "New Group") { id title } }"}
Response:
{ "data": { "create_group": { "id": "group_mm0939df", "title": "New Group" } } }
Monday.com uses cursor-based pagination for items with
items_pagenext_items_page# First page POST /monday/v2 {"query": "{ boards(ids: [BOARD_ID]) { items_page(limit: 50) { cursor items { id name } } } }"}Next page using cursor
POST /monday/v2 {"query": "{ next_items_page(cursor: "CURSOR_VALUE", limit: 50) { cursor items { id name } } }"}
Response includes
cursor{ "data": { "boards": [{ "items_page": { "cursor": "MSw5NzI4...", "items": [...] } }] } }
const response = await fetch('https://gateway.maton.ai/monday/v2', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.MATON_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ query: `{ boards(limit: 10) { id name items_page(limit: 20) { items { id name } } } }` }) }); const data = await response.json();
import os import requestsresponse = requests.post( 'https://gateway.maton.ai/monday/v2', headers={ 'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}', 'Content-Type': 'application/json' }, json={ 'query': '{ boards(limit: 10) { id name items_page(limit: 20) { items { id name } } } }' } ) data = response.json()
color_mm09e48wgroup_mm0939dftopicsaccountpublicprivateshareactivearchiveddeletedall| Status | Meaning |
|---|---|
| 400 | Missing Monday.com connection or GraphQL validation error |
| 401 | Invalid or missing Maton API key |
| 403 | Insufficient OAuth scope for the operation |
| 429 | Rate limited |
| 4xx/5xx | Passthrough error from Monday.com API |
GraphQL errors are returned in the
errors{ "data": {}, "errors": [ { "message": "Unauthorized field or type", "path": ["account"], "extensions": { "code": "UNAUTHORIZED_FIELD_OR_TYPE" } } ] }
MATON_API_KEYecho $MATON_API_KEY
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
mondayhttps://gateway.maton.ai/monday/v2https://gateway.maton.ai/v2No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.