gws-gmail-users-labels-list
Gmail: List all labels in the user's mailbox.
SKILL.md.claude/skills/gws-gmail-users-labels-list/SKILL.md
GitHubgmail users labels list
List all labels (both system labels like INBOX, UNREAD, and custom user labels) in the user's mailbox.
Usage
gws gmail users labels list --params '<JSON>'
Parameters (--params JSON)
| Parameter | Required | Default | Description |
|---|---|---|---|
userId |
✓ | — | The user's email address or "me" for the authenticated user |
Examples
# List all labels
gws gmail users labels list --params '{"userId": "me"}'
Tips
- Returns a list of label objects containing their
id,name,type(e.g.systemoruser), and configuration details. - Useful for discovering the exact label IDs to use in filtering (e.g., when listing messages) or modifying labels (e.g., when updating messages).