monday
# Monday.com
Read boards, items, and workspaces directly via `api.monday.com` (GraphQL).
## Setup (one-time)
1. In Monday.com, click your **profile picture** (top right)
2. Select **Developers** — this opens the Developer Center
3. Click **API token → Show**
4. Copy your personal token
5. Set the environment variable:
```
MONDAY_API_TOKEN=your_token_here
```
## Commands
### Get your account info
```bash
python3 /mnt/skills/user/monday/scripts/monday.py me
```
### List all boards
```bash
python3 /mnt/skills/user/monday/scripts/monday.py list-boards
python3 /mnt/skills/user/monday/scripts/monday.py list-boards --limit 50
```
### Get board details (columns, groups)
```bash
python3 /mnt/skills/user/monday/scripts/monday.py get-board <board_id>
```
### List items on a board
```bash
python3 /mnt/skills/user/monday/scripts/monday.py list-items <board_id>
python3 /mnt/skills/user/monday/scripts/monday.py list-items <board_id> --limit 50
```
### List workspaces
```bash
python3 /mnt/skills/user/monday/scripts/monday.py list-workspaces
```
### List users
```bash
python3 /mnt/skills/user/monday/scripts/monday.py list-users
```
## Notes
- Free plan: 2 seats, unlimited boards. API access works on free.
- Board IDs are numeric — find them in the board URL or via `list-boards`.
- Monday uses GraphQL only (single endpoint). No REST API.
- API version pinned to `2024-04`.
标签
skill
ai