# Agentio Gmail > Use when interacting with Gmail - list, read, search, send (with attachments/inline images), draft, reply (via --reply-to), archive, mark, download attachments, or export to PDF. Requires agentio CLI with a configured Gmail profile. - Skill: `tomevault-io/agentio-gmail` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/agentio-gmail` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/agentio-gmail/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/agentio-gmail --- # 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 `. ## List Messages ```bash agentio gmail list [--limit N] [--query QUERY] [--label LABEL] ``` Options: - `--limit `: Number of messages (default: 10) - `--query `: Gmail search query - `--label `: Filter by label (repeatable) ## Get a Message ```bash agentio gmail get [--format text|html|raw] [--body-only] ``` Options: - `--format`: Body format - `text` (default), `html`, or `raw` - `--body-only`: Output only the message body ## Search Messages ```bash agentio gmail search --query [--limit N] ``` Query syntax: - `from:john@example.com` - From specific sender - `to:me` - Sent to you - `after:2024/01/01` / `before:2024/12/31` - Date filters - `newer_than:7d` / `older_than:1m` - Relative dates (d/m/y) - `label:inbox` - In specific label - `is:unread` / `is:starred` - Status filters - `has:attachment` - With attachments - `subject:invoice` - Search subject Combine: `from:boss@work.com is:unread newer_than:7d` ## Send an Email ```bash agentio gmail send --to --subject [--body ] [options] ``` Options: - `--to `: Recipient (repeatable, required unless --reply-to) - `--cc `: CC recipient (repeatable) - `--bcc `: BCC recipient (repeatable) - `--subject `: Email subject (required unless --reply-to) - `--body `: Email body (or pipe via stdin) - `--html`: Treat body as HTML - `--reply-to `: Thread ID to reply to (derives to/subject from thread) - `--attachment `: File to attach (repeatable) - `--inline `: Inline image (repeatable). Supports PNG, JPG, GIF only (not SVG) ### Replying to a Thread ```bash agentio gmail send --reply-to --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: ```bash agentio gmail send \ --to user@example.com \ --subject "Report" \ --html \ --body '

See chart:

' \ --inline chart1:./chart.png ``` Reference inline images in HTML using `src="cid:"`. ## Create a Draft ```bash agentio gmail draft --to --subject [--body ] [options] ``` Takes the same options as `send`. Supports `--reply-to` for draft replies: ```bash agentio gmail draft --reply-to --body "Draft reply" ``` ## Archive a Message ```bash agentio gmail archive ``` ## Mark as Read/Unread ```bash agentio gmail mark --read agentio gmail mark --unread ``` ## Download Attachments ```bash agentio gmail attachment [--name ] [--output ] ``` Options: - `--name `: Download specific attachment by filename (downloads all if not specified) - `--output `: Output directory (default: current directory) ## Export Message as PDF ```bash agentio gmail export [--output ] ``` Options: - `--output `: Output file path (default: `message.pdf`) Requires Chrome, Chromium, or Edge browser installed. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/plosson) — claim your Tome and manage your conversions.