# monday

> Monday.com project management integration. Create, read, update, and delete boards, items, and task data. Use when working with Monday.com tasks, dashboards, automations, or syncing project data.

- Author: jashiagrafana
- Repository: jashiagrafana/monday-skill
- Version: 20260126155948
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/jashiagrafana/monday-skill
- Web: https://mule.run/skillshub/@@jashiagrafana/monday-skill~monday:20260126155948

---

---
name: monday
description: "Monday.com project management integration. Create, read, update, and delete boards, items, and task data. Use when working with Monday.com tasks, dashboards, automations, or syncing project data."
---

# Monday.com Skill

This skill provides integration with Monday.com's GraphQL API for project management automation, task creation, status updates, and board operations.

## Quick Start

### List all boards
```bash
monday-api.py list-boards --api-key $MONDAY_API_KEY --json
```

### Get details for a specific board
```bash
monday-api.py get-board --api-key $MONDAY_API_KEY --board-id 18397188688 --json
```

### List items in a board
```bash
monday-api.py list-items --api-key $MONDAY_API_KEY --board-id 18397188688 --limit 50 --json
```

### Get board columns (schema)
```bash
monday-api.py get-board-columns --api-key $MONDAY_API_KEY --board-id 18397188688 --json
```

### Create a task
```bash
monday-api.py create-item --api-key $MONDAY_API_KEY --board-id 18397188688 --item-name "New Task"
```

### Update an item's column value
```bash
monday-api.py update-item --api-key $MONDAY_API_KEY --item-id 11104702890 --board-id 18397188688 --column-id status --value '{"index":1}'
```

### Delete an item
```bash
monday-api.py delete-item --api-key $MONDAY_API_KEY --item-id 11104702890
```

## Setup

1. **Get your API key** from Monday.com (Settings → Integrations → API)
2. **Store in Clawdbot config** under `skills.entries.monday.apiKey`, or set `MONDAY_API_KEY` environment variable

## API Reference

See `references/api-reference.md` for GraphQL queries, mutations, and field documentation.

## Key Capabilities

- **Boards**: List, retrieve, create, delete boards
- **Items**: Create tasks, update fields (status, priority, dates), delete items
- **Columns**: Query board schema and column types
- **Batch operations**: Handle multiple items efficiently
- **Custom fields**: Set any column value via JSON

## Column Types

Common Monday.com column types and example values:

- `status`: `{"status":"Not started"}` or `{"status":"Done"}`
- `priority`: `{"priority":"High"}`, `{"priority":"Medium"}`, `{"priority":"Low"}`
- `date`: `{"date":"2026-12-31"}`
- `text`: `{"text":"Some value"}`
- `number`: `{"number":42}`
- `assignee`: `{"assignee":12345}` (user ID)
- `timeline`: `{"from_date":"2026-01-01","to_date":"2026-12-31"}`

## Rate Limits

Monday.com allows 5000 requests per hour with complexity-based throttling. The skill handles standard operations efficiently.

## Examples

### Create a task with multiple fields
```bash
monday-api.py create-item \
  --api-key $MONDAY_API_KEY \
  --board-id 1234567 \
  --item-name "Design homepage" \
  --column-values '{"status":"Not started","priority":"High","assignee":98765}'
```

### Update task status to Done
```bash
monday-api.py update-item \
  --api-key $MONDAY_API_KEY \
  --item-id 7654321 \
  --column-values '{"status":"Done"}'
```

### List all items in a board with pagination
```bash
monday-api.py list-items \
  --api-key $MONDAY_API_KEY \
  --board-id 1234567 \
  --limit 100 \
  --json
```

## Troubleshooting

**"API Error"**: Check that your API key is valid and has the correct permissions.

**"Board not found"**: Verify the board ID is correct. Use `list-boards` to see all accessible boards.

**"Invalid column values"**: Ensure JSON format is correct and column IDs/types match the board schema.