tomevault-io Gmail Operations with agentio
Use agentio gmail commands to interact with Gmail. Multiple profiles can be configured - the default profile is used unless you specify --profile <name>.
List Messages
agentio gmail list [--limit N] [--query QUERY] [--label LABEL]
Options:
--limit <n>: Number of messages (default: 10)--query <query>: Gmail search query--label <label>: Filter by label (repeatable)
Get a Message
agentio gmail get <message-id> [--format text|html|raw] [--body-only]
Options:
--format: Body format -text(default),html, orraw--body-only: Output only the message body
Search Messages
agentio gmail search --query <query> [--limit N]
Query syntax:
from:john@example.com- From specific senderto:me- Sent to youafter:2024/01/01/before:2024/12/31- Date filtersnewer_than:7d/older_than:1m- Relative dates (d/m/y)label:inbox- In specific labelis:unread/is:starred- Status filtershas:attachment- With attachmentssubject:invoice- Search subject
Combine: from:boss@work.com is:unread newer_than:7d
Send an Email
agentio gmail send --to <email> --subject <subject> [--body <body>] [options]
Options:
--to <email>: Recipient (repeatable, required unless --reply-to)--cc <email>: CC recipient (repeatable)--bcc <email>: BCC recipient (repeatable)--subject <subject>: Email subject (required unless --reply-to)--body <body>: Email body (or pipe via stdin)--html: Treat body as HTML--reply-to <thread-id>: Thread ID to reply to (derives to/subject from thread)--attachment <path>: File to attach (repeatable)--inline <cid:path>: Inline image (repeatable). Supports PNG, JPG, GIF only (not SVG)
Replying to a Thread
agentio gmail send --reply-to <thread-id> --body "Thanks!"
When using --reply-to, the recipient and subject are derived from the thread. You can override them with explicit --to/--subject.
Inline Images
To embed images directly in HTML emails, use --inline with a content ID and file path:
agentio gmail send \
--to user@example.com \
--subject "Report" \
--html \
--body '<p>See chart:</p><img src="cid:chart1">' \
--inline chart1:./chart.png
Reference inline images in HTML using src="cid:<contentId>".
Create a Draft
agentio gmail draft --to <email> --subject <subject> [--body <body>] [options]
Takes the same options as send. Supports --reply-to for draft replies:
agentio gmail draft --reply-to <thread-id> --body "Draft reply"
Archive a Message
agentio gmail archive <message-id>
Mark as Read/Unread
agentio gmail mark <message-id> --read
agentio gmail mark <message-id> --unread
Download Attachments
agentio gmail attachment <message-id> [--name <filename>] [--output <dir>]
Options:
--name <filename>: Download specific attachment by filename (downloads all if not specified)--output <dir>: Output directory (default: current directory)
Export Message as PDF
agentio gmail export <message-id> [--output <path>]
Options:
--output <path>: Output file path (default:message.pdf)
Requires Chrome, Chromium, or Edge browser installed.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.