monday_skill

Overview

This skill lets you call the Monday.com GraphQL API directly from shell using curl to manage boards, items, groups, and columns. It focuses on practical, scriptable operations: query data, create or update items with column values, delete items, and create boards. Examples assume an API token in MONDAY_API_KEY and show safe curl usage when piping.

How this skill works

The skill builds GraphQL queries and mutations as JSON files and posts them to https://api.monday.com/v2 with the Authorization and API-Version headers. It wraps curl calls in bash -c to avoid environment-variable loss when piping, and uses GraphQL variables for complex payloads and escaped JSON strings for column_values. Typical flows include listing boards, fetching board details, reading items, creating/updating items, and deleting items.

When to use it

• Automate creating or updating items in Monday.com boards from scripts
• Sync tasks or project data between Monday.com and other systems
• Inspect boards, groups, and column schemas before bulk updates
• Build CI/CD hooks or cron jobs that adjust boards programmatically
• Quick ad-hoc queries and mutations from a terminal or remote server

Best practices

• Store the API token in MONDAY_API_KEY and never hard-code it
• Always include API-Version header (use 2024-10) to avoid breaking changes
• Use GraphQL variables for payloads to simplify escaping and reuse
• Query board columns and groups first to get exact column and group IDs
• Rate-limit bulk operations and add retries to respect API limits
• When sending column_values, pass them as escaped JSON strings to the GraphQL variable

Example use cases

• List all boards to find a target board_id and inspect available columns
• Create a new item in a specified group with status and date column values
• Update multiple column values on an existing item (status -> Done, set date)
• Delete stale or test items as part of a cleanup script
• Create a new board programmatically as part of a client onboarding flow