gh-dnvriend-google-gmail-tool-plugins-google-gmail-tool/commands/mail-list.md

description, argument-hint

description	argument-hint
List Gmail messages with filtering options	query

List Gmail messages or threads with optional filtering.

Usage

google-gmail-tool mail list [--query "QUERY"] [--today] [-n N] [--text]

Arguments

• --query "QUERY": Gmail search query (optional)
• --today: Filter emails from today only
• -n N: Max results (default: 50, max: 500)
• --text: Output in text format
• -v/-vv/-vvv: Verbosity (INFO/DEBUG/TRACE)

Examples

# List 50 most recent threads
google-gmail-tool mail list

# Find unread emails from today
google-gmail-tool mail list --today --query "is:unread"

# List with JSON output
google-gmail-tool mail list --query "from:team@company.com" -n 10

Output

Returns JSON array with id, threadId, snippet, from, to, subject, date.