Agent skill

monday

Monday.com API for work management. Use when user mentions "Monday.com", "monday.com", shares a Monday link, "Monday board", or asks about Monday workspace.

View SKILL.md on GitHub Repository
Stars 50
Forks 8

Install this agent skill to your Project

npx add-skill https://github.com/vm0-ai/vm0-skills/tree/main/monday

SKILL.md

Monday.com API

Use the Monday.com GraphQL API via direct curl calls to manage boards, items, and project data.

Official docs: https://developer.monday.com/api-reference/

When to Use

Use this skill when you need to:

  • Query boards and items from Monday.com
  • Create, update, or delete items in boards
  • Manage board columns and groups
  • Sync data between Monday.com and other systems
  • Automate project workflows

Prerequisites

  1. Log in to Monday.com
  2. Go to your avatar → Developers → My Access Tokens
  3. Generate a new API token
  4. Store it in the environment variable MONDAY_TOKEN
bash
export MONDAY_TOKEN="your-api-token"

API Info

  • GraphQL endpoint: https://api.monday.com/v2
  • All requests are POST
  • Requires Authorization header with API token
  • Requires API-Version header (use 2024-10)

How to Use

All examples below assume you have MONDAY_TOKEN set.

1. Get Current User

Query the authenticated user's info:

Write to /tmp/monday_request.json:

json
{
  "query": "query { me { id name email } }"
}

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

2. List All Boards

Get all boards in your account:

Write to /tmp/monday_request.json:

json
{
  "query": "query { boards (limit: 10) { id name state items_count } }"
}

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

3. Get Board Details

Get a specific board with its groups and columns:

Write to /tmp/monday_request.json:

json
{
  "query": "query { boards (ids: <your-board-id>) { id name groups { id title } columns { id title type } } }"
}

Replace <your-board-id> with an actual board ID from the "List All Boards" response (example 2).

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

4. Get Items from a Board

Get items (rows) from a specific board:

Write to /tmp/monday_request.json:

json
{
  "query": "query { boards (ids: <your-board-id>) { items_page (limit: 10) { items { id name column_values { id text value } } } } }"
}

Replace <your-board-id> with an actual board ID from the "List All Boards" response (example 2).

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

5. Create a New Item

Create a new item in a board:

Write to /tmp/monday_request.json:

json
{
  "query": "mutation { create_item (board_id: <your-board-id>, group_id: \"<your-group-id>\", item_name: \"<your-item-name>\") { id name } }"
}

Replace the following values:

  • <your-board-id>: An actual board ID from the "List All Boards" response (example 2)
  • <your-group-id>: A group ID from the "Get Board Details" response (example 3, groups array)
  • <your-item-name>: Your desired name for the new item

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

6. Create Item with Column Values

Create an item with specific column values:

Write to /tmp/monday_request.json:

json
{
  "query": "mutation ($boardId: ID!, $groupId: String!, $itemName: String!, $columnValues: JSON!) { create_item (board_id: $boardId, group_id: $groupId, item_name: $itemName, column_values: $columnValues) { id name } }",
  "variables": {
    "boardId": "<your-board-id>",
    "groupId": "<your-group-id>",
    "itemName": "<your-item-name>",
    "columnValues": "{\"status\": {\"label\": \"Working on it\"}, \"date\": {\"date\": \"2025-01-15\"}}"
  }
}

Replace the following values:

  • <your-board-id>: An actual board ID from the "List All Boards" response (example 2)
  • <your-group-id>: A group ID from the "Get Board Details" response (example 3, groups array)
  • <your-item-name>: Your desired name for the new item

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

7. Update an Item

Update an existing item's column values:

Write to /tmp/monday_request.json:

json
{
  "query": "mutation ($boardId: ID!, $itemId: ID!, $columnValues: JSON!) { change_multiple_column_values (board_id: $boardId, item_id: $itemId, column_values: $columnValues) { id name } }",
  "variables": {
    "boardId": "<your-board-id>",
    "itemId": "<your-item-id>",
    "columnValues": "{\"status\": {\"label\": \"Done\"}}"
  }
}

Replace the following values:

  • <your-board-id>: An actual board ID from the "List All Boards" response (example 2)
  • <your-item-id>: An item ID from the "Get Items from a Board" response (example 4)

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

8. Delete an Item

Delete an item from a board:

Write to /tmp/monday_request.json:

json
{
  "query": "mutation { delete_item (item_id: <your-item-id>) { id } }"
}

Replace <your-item-id> with an actual item ID from the "Get Items from a Board" response (example 4).

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

9. Create a New Board

Create a new board:

Write to /tmp/monday_request.json:

json
{
  "query": "mutation { create_board (board_name: \"My New Board\", board_kind: public) { id name } }"
}

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

10. Search Items

Search for items across boards:

Write to /tmp/monday_request.json:

json
{
  "query": "query { items_page_by_column_values (limit: 10, board_id: <your-board-id>, columns: [{column_id: \"name\", column_values: [\"Task\"]}]) { items { id name } } }"
}

Replace <your-board-id> with an actual board ID from the "List All Boards" response (example 2).

Then run:

bash
curl -s -X POST "https://api.monday.com/v2" --header "Authorization: $(printenv MONDAY_TOKEN)" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json

Common Column Types

Column Type Value Format
Status {"label": "Done"}
Date {"date": "2025-01-15"}
Text "Your text here"
Number "123"
Person {"id": 12345678}
Dropdown {"labels": ["Option1", "Option2"]}
Checkbox {"checked": true}

Guidelines

  1. Use variables for complex queries: GraphQL variables make escaping easier
  2. Check column IDs: Use the board query to get exact column IDs before updating
  3. API versioning: Always include API-Version header for consistent behavior
  4. Rate limits: API has rate limits; add delays for bulk operations
  5. Column values are JSON strings: When using column_values, pass as escaped JSON string

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

vm0-ai/vm0-skills

brave-search

Brave Search API for web search. Use when user says "search web", "Brave search", or asks to "find on web" without specifying Google.

50 8
Explore
vm0-ai/vm0-skills

supadata

Supadata API for YouTube/web data. Use when user mentions "Supadata", "YouTube data", "channel stats", or web scraping data.

50 8
Explore
vm0-ai/vm0-skills

roadmap-planning

Build and prioritize product roadmaps using scoring models like RICE, ICE, and value-effort matrices. Activate when creating a product roadmap, prioritizing features, sequencing initiatives, mapping dependencies, balancing team capacity, choosing between Now/Next/Later or quarterly planning, or communicating roadmap tradeoffs to executives and stakeholders.

50 8
Explore
vm0-ai/vm0-skills

qdrant

Qdrant API for vector search. Use when user mentions "Qdrant", "vector database", "semantic search", or embeddings storage.

50 8
Explore
vm0-ai/vm0-skills

calendly

Calendly scheduling API. Use when user mentions "Calendly", "calendly.com", "schedule a meeting", "booking link", "event types", or asks about interview scheduling.

50 8
Explore
vm0-ai/vm0-skills

stripe

Stripe API for payments. Use when user mentions "Stripe", "payment", "subscription", "billing", "invoice", or asks about payment processing.

50 8
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results