agentio-gmail
Use when interacting with Gmail via the agentio CLI - list, read, search, send, draft, reply, archive, mark, attachments, export.
What this skill does
# Gmail via agentio Auto-generated from `agentio skill gmail`. Do not edit by hand. ## agentio gmail list List messages Options: - `--profile <name>`: Profile name (optional if only one profile exists) - `--limit <n>`: Number of messages (default: 10) - `--query <query>`: Gmail search query (see "gmail search --help" for syntax) - `--label <label>`: Filter by label (repeatable) (default: ) ``` Examples: # 10 most recent messages agentio gmail list # 25 most recent in the inbox agentio gmail list --limit 25 --label INBOX # unread messages from the last week agentio gmail list --query "is:unread newer_than:7d" # use a specific profile agentio gmail list --profile [email protected] ``` ## agentio gmail get <message-id> Get a message Options: - `--profile <name>`: Profile name (optional if only one profile exists) - `--format <format>`: Body format: text, html, or raw (default: text) - `--body-only`: Output only the message body ``` Examples: # full message with headers agentio gmail get 18c4f1a2b3d # plain-text body only (good for piping to a file) agentio gmail get 18c4f1a2b3d --body-only > message.txt # raw HTML body agentio gmail get 18c4f1a2b3d --format html --body-only ``` ## agentio gmail search Search messages using Gmail query syntax Options: - `--query <query>`: Search query - `--profile <name>`: Profile name (optional if only one profile exists) - `--limit <n>`: Max results (capped at 10000; >100 returns IDs only without per-message metadata) (default: 10) - `--ids-only`: Print one message ID per line (pipe-friendly into archive/label) ``` Examples: # unread mail from a specific sender in the last week agentio gmail search --query "from:[email protected] is:unread newer_than:7d" # messages with attachments after a date agentio gmail search --query "has:attachment after:2024/01/01" --limit 25 # subject keyword in inbox, excluding spam agentio gmail search --query "subject:invoice label:inbox -label:spam" # exact phrase across all mail agentio gmail search --query '"quarterly report"' # bulk pipe: archive everything matching a query agentio gmail search --query "from:[email protected] older_than:6m" --limit 5000 --ids-only \ | agentio gmail archive Query syntax: from:, to:, cc:, subject:, label:, is:unread|starred|important, has:attachment, after:YYYY/MM/DD, before:YYYY/MM/DD, newer_than:7d, older_than:1m. Combine with spaces (AND), OR, or - to negate. ``` ## agentio gmail send Send an email Options: - `--profile <name>`: Profile name (optional if only one profile exists) - `--to <email>`: Recipient (repeatable, required unless --reply-to) (default: ) - `--cc <email>`: CC recipient (repeatable) (default: ) - `--bcc <email>`: BCC recipient (repeatable) (default: ) - `--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) (default: ) - `--inline <cid:path>`: Inline image (repeatable, format: contentId:filepath). Supports PNG, JPG, GIF only (not SVG) (default: ) ``` Examples: # plain-text email agentio gmail send --to [email protected] --subject "Hello" --body "Hi Alice!" # body from stdin (great for piping) echo "Sent via pipe" | agentio gmail send --to [email protected] --subject "Note" # reply within an existing thread (to/subject derived from thread) agentio gmail send --reply-to 18c4f1a2b3d --body "Thanks!" # HTML body with an attachment and an inline image agentio gmail send --to [email protected] --cc [email protected] \ --subject "Report" --html \ --body '<p>See chart:</p><img src="cid:chart1">' \ --attachment ./report.pdf --inline chart1:./chart.png ``` ## agentio gmail draft Create an email draft Options: - `--profile <name>`: Profile name (optional if only one profile exists) - `--to <email>`: Recipient (repeatable, required unless --reply-to) (default: ) - `--cc <email>`: CC recipient (repeatable) (default: ) - `--bcc <email>`: BCC recipient (repeatable) (default: ) - `--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) (default: ) - `--inline <cid:path>`: Inline image (repeatable, format: contentId:filepath). Supports PNG, JPG, GIF only (not SVG) (default: ) ``` Examples: # save a draft for later editing in Gmail agentio gmail draft --to [email protected] --subject "Hello" --body "Draft body" # draft a reply within an existing thread agentio gmail draft --reply-to 18c4f1a2b3d --body "Draft reply" # draft with attachment, body from stdin cat message.txt | agentio gmail draft --to [email protected] \ --subject "Notes" --attachment ./notes.pdf ``` ## agentio gmail archive [message-id...] Archive one or more messages (bulk-safe via batchModify) Options: - `--profile <name>`: Profile name (optional if only one profile exists) - `--chunk-size <n>`: IDs per batchModify call (max 1000) (default: 1000) - `--max-retries <n>`: Retries per chunk on 429/5xx (default: 5) - `--dry-run`: Print chunk plan without calling the API ``` Examples: # archive one message agentio gmail archive 18c4f1a2b3d # archive several at once agentio gmail archive 18c4f1a2b3d 18c4f1a2b3e 18c4f1a2b3f # archive thousands by piping IDs from search (uses messages.batchModify, 1000/call) agentio gmail search --query "from:[email protected] older_than:1y" --limit 5000 --ids-only \ | agentio gmail archive # preview the chunk plan without calling the API echo "id1 id2 id3" | agentio gmail archive --dry-run ``` ## agentio gmail mark <message-id...> Mark one or more messages as read or unread Options: - `--profile <name>`: Profile name (optional if only one profile exists) - `--read`: Mark as read - `--unread`: Mark as unread ``` Examples: # mark one message as read agentio gmail mark 18c4f1a2b3d --read # mark several back to unread agentio gmail mark 18c4f1a2b3d 18c4f1a2b3e --unread ``` ## agentio gmail labels list List all labels Options: - `--profile <name>`: Profile name (optional if only one profile exists) ``` Examples: # list every label (system + user) agentio gmail labels list # list labels for a specific profile agentio gmail labels list --profile [email protected] ``` ## agentio gmail labels create <name> Create a new label Options: - `--profile <name>`: Profile name (optional if only one profile exists) ``` Examples: # create a top-level label agentio gmail labels create receipts # create a nested label (use "/" for hierarchy) agentio gmail labels create auto/receipts # nested two levels deep agentio gmail labels create work/clients/acme ``` ## agentio gmail labels delete <name-or-id> Delete a user label Options: - `--profile <name>`: Profile name (optional if only one profile exists) ``` Examples: # delete a user label by name agentio gmail labels delete receipts # delete a nested label agentio gmail labels delete auto/receipts # delete by label ID agentio gmail labels delete Label_1234567890 ``` ## agentio gmail labels rename <old> <new> Rename a user label Options: - `--profile <name>`: Profile name (optional if only one profile exists) ``` Examples: # rename a label agentio gmail labels rename receipts invoices # move a label into a nested hierarchy agentio gmail labels rename receipts auto/receipts ``` ## agentio gmail filters list List all filters Options: - `--profile <name>`: Profile name (optional if only one profile exists) ``` Examples: # list every filter agentio gmail filters list # list filters for a specific profile agentio gmail filter
Related in Productivity
gitea-workflow
IncludedOrchestrate agile development workflows for Gitea repositories using the tea CLI. Use when working with Gitea-hosted repos and asking to 'run the workflow', 'continue working', 'what's next', 'complete the task cycle', 'start my day', 'end the sprint', 'implement the next task', or wanting guided step-by-step development assistance. Keywords: workflow, orchestrate, agile, task cycle, sprint, daily, implement, review, PR, standup, retrospective, gitea, tea.
microsoft-graph-gateway
IncludedRoute Microsoft Graph work in this workspace. Use when users want to read or write Outlook mail, calendar events, contacts, OneDrive or SharePoint files, Teams, Planner, To Do, users, groups, directory data, or arbitrary Microsoft Graph endpoints from VS Code. Prefer WorkIQ for common read scenarios. Use Microsoft Graph for write actions and gap-read scenarios that need exact Graph properties, filters, permissions, or endpoints.
copilotkit
IncludedUse when building with CopilotKit — setup, development, integrations, debugging, upgrading, or contributing. Routes to the appropriate specialized skill based on the task.
wordly-wisdom
IncludedProvides calibrated decision analysis using Charlie Munger-style multiple mental models, inversion, incentive mapping, circle-of-competence checks, misjudgment audits, second-order effects, and forecast updates. Use when the user asks for an oracle take, a hard call, a decision memo, a premortem, an outside view, a red-team, a sanity-check, what am I missing, think this through, or wants a strategy, hire, investment, plan, product, partnership, or major life choice analysed. Avoid for simple factual lookups or time-sensitive legal, medical, or market questions without fresh evidence.
swain-session
IncludedSession management and project status dashboard. Owns the full session lifecycle (start/work/close/resume), focus lane, bookmarks, worktree detection, and tab naming. Also serves as the project status dashboard — shows active epics, progress, actionable next steps, blocked items, tasks, GitHub issues, and recommendations. Worktree creation is deferred to swain-do task dispatch (SPEC-195). Triggers on: 'session', 'status', 'what's next', 'dashboard', 'overview', 'where are we', 'what should I work on', 'show me priorities', 'bookmark', 'focus on', 'session info'.
gandi
IncludedComprehensive Gandi domain registrar integration for domain and DNS management. Register and manage domains, create/update/delete DNS records (A, AAAA, CNAME, MX, TXT, SRV, and more), configure email forwarding and aliases, check SSL certificate status, create DNS snapshots for safe rollback, bulk update zone files, and monitor domain expiration. Supports multi-domain management, zone file import/export, and automated DNS backups. Includes both read-only and destructive operations with safety controls.