List labels
list_labelsGet all Gmail labels with IDs, or pass a label_id to retrieve that label's message and thread counts.
Instructions
Without label_id: lists every label in the mailbox — system labels (INBOX, SENT, DRAFT, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, CATEGORY_*) and user labels with their ids — the vocabulary that list_messages label_ids and modify_message add/remove_label_ids speak. With label_id: fetches that one label including its counts (messagesTotal, messagesUnread, threadsTotal, threadsUnread), which the plain list does not carry.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_labels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label_id | No | Fetch one label with counts instead of listing all. |