List folders
Tool ID: email_folders_list
Summary
Lists folders in a mailbox (Inbox, Sent, Drafts, and others) and how many unseen messages each folder has.
When to use it
- Discover folder names — Especially on Gmail, where Drafts/Sent may use special names.
- Check unread mail — See which folders have unseen messages before searching.
- Choose where to search — Confirm the folder label before a search or get.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Email credentials | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
mailbox |
No | Account id from List mailboxes. Omit to use the default mailbox. |
What you get back
| Field | Meaning |
|---|---|
mailbox |
Which account was queried |
count |
How many folders were returned |
folders |
Folder names with unseen counts |
Example prompts
List the folders in our default mailbox and how many unread messages each has.
Show folders for the sales mailbox.
What is the exact name of the Drafts folder on our Gmail account?
Tips
- Default mailbox — Omit the account name unless you need a specific one.
- Gmail — Drafts may appear as
[Gmail]/Draftsand Sent as[Gmail]/Sent Mail; listing folders shows the real names.