home / skills / openclaw / skills / monday

monday skill

safe

This skill helps you manage monday.com boards and items via GraphQL, creating tasks, updating statuses, and automating workflows efficiently.

npx playbooks add skill openclaw/skills --skill monday

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.8 KB

---
name: monday
description: Manage monday.com boards, items, and workflows via GraphQL API. Create tasks, update statuses, and automate work.
metadata: {"clawdbot":{"emoji":"📋","requires":{"env":["MONDAY_API_TOKEN"]}}}
---

# Monday.com

Work management platform.

## Environment

```bash
export MONDAY_API_TOKEN="xxxxxxxxxx"
```

## List Boards

```bash
curl "https://api.monday.com/v2" \
  -H "Authorization: $MONDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ boards(limit:10) { id name } }"}'
```

## Get Board Items

```bash
curl "https://api.monday.com/v2" \
  -H "Authorization: $MONDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ boards(ids: [BOARD_ID]) { items_page { items { id name column_values { id text } } } } }"}'
```

## Create Item

```bash
curl "https://api.monday.com/v2" \
  -H "Authorization: $MONDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "mutation { create_item(board_id: BOARD_ID, item_name: \"New Task\") { id } }"}'
```

## Update Item Column

```bash
curl "https://api.monday.com/v2" \
  -H "Authorization: $MONDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "mutation { change_column_value(board_id: BOARD_ID, item_id: ITEM_ID, column_id: \"status\", value: \"{\\\"label\\\":\\\"Done\\\"}\") { id } }"}'
```

## Add Update (Comment)

```bash
curl "https://api.monday.com/v2" \
  -H "Authorization: $MONDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "mutation { create_update(item_id: ITEM_ID, body: \"Task completed!\") { id } }"}'
```

## Get User Info

```bash
curl "https://api.monday.com/v2" \
  -H "Authorization: $MONDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ me { id name email } }"}'
```

## Links
- Dashboard: https://monday.com
- Docs: https://developer.monday.com/api-reference

Overview

This skill manages monday.com boards, items, and workflows through the monday.com GraphQL API. It enables creating tasks, updating item columns (like status), posting updates (comments), and querying boards and user info. Set the MONDAY_API_TOKEN environment variable to authenticate.

How this skill works

The skill sends GraphQL queries and mutations to https://api.monday.com/v2 using the provided API token. It can list boards, fetch items with column values, create new items, change column values (for status, dates, text, etc.), and add updates to items. Responses are parsed to return item IDs, board lists, and user details for use in automation or integrations.

When to use it

Automate task creation from external systems or forms
Update item status or other column values programmatically
Fetch board and item data for reporting or backups
Post progress notes or comments to items automatically
Integrate monday.com with CI/CD, chatops, or ticketing systems

Best practices

Store MONDAY_API_TOKEN securely in environment variables or secrets manager
Limit queries to needed fields to reduce payload and improve performance
Use item IDs and board IDs returned by the API rather than names to avoid ambiguity
Handle API rate limits and errors: implement retries with exponential backoff
Validate column IDs and value formats (e.g., status uses JSON with a label) before sending mutations

Example use cases

Create a new task on a specific board when a customer support ticket is filed
Mark items as Done by changing the status column after automated checks pass
Pull items and column values to generate a daily backlog or sprint report
Add an update to an item when a deployment completes to keep team context
Sync tasks from another tool by mapping fields and creating or updating items via GraphQL

FAQ

How do I authenticate requests?

Set MONDAY_API_TOKEN in your environment and include it as the Authorization header for calls to https://api.monday.com/v2.

How do I update a status column?

Use the change_column_value mutation with column_id set to the status column and value as JSON, for example: {"label":"Done"}.