skills.rest
plosson
plossonCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agentio-gmail

Manage Gmail messages, drafts, labels, and filters via the agentio CLI.

2|Updated Jan 3, 2026
Search Tags:#ci/cd#cli#email automation#gmail#filters#inbox triage#agentio
One-click install
npx skills add https://github.com/plosson/agentio --skill agentio-gmail-plosson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentio-gmail
Source: https://github.com/plosson/agentio/tree/main/claude/skills/agentio-gmail
Command: npx skills add https://github.com/plosson/agentio --skill agentio-gmail-plosson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reading, searching, sending, and organizing Gmail from scripts or CI pipelines normally requires OAuth setup and API boilerplate. This Skill exposes every Gmail operation as a plain agentio CLI command that agents and workflows can call directly. ## Core Features & Use Cases - Message Operations: List, search, read, send, draft, reply, archive, and mark messages as read or unread, with bulk-safe batching for thousands of IDs. - Organization: Create, rename, and delete labels, apply or remove labels on messages and threads, and manage Gmail filters programmatically. - Attachments & Export: Download attachments by filename and export messages as PDF. - Use Case: In a GitHub Actions workflow, search for unread invoices older than a month, pipe the IDs into archive, and send a Slack-style summary email — all with three CLI commands. ## Quick Start Use the agentio gmail skill to list my 10 most recent unread messages and show their senders and subjects.

Frequently Asked Questions about agentio-gmail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Gmail from the command line?▼

Run agentio gmail search with a --query flag using standard Gmail syntax like from:, is:unread, has:attachment, and newer_than:7d. Add --ids-only to print one message ID per line for piping into archive or label commands.

How to send an email from a script or CI pipeline?▼

Use agentio gmail send with --to, --subject, and --body flags, or pipe the body via stdin. For agents, --subject-file and --body-file read UTF-8 files to avoid shell quoting issues, and --spec accepts a single JSON file.

Can I archive thousands of Gmail messages at once?▼

Yes. Pipe IDs from agentio gmail search --ids-only into agentio gmail archive, which uses messages.batchModify with up to 1000 IDs per call. Use --dry-run to preview the chunk plan and --max-retries to handle rate limits.

Does agentio gmail support multiple Gmail accounts?▼

Yes. Every command accepts a --profile flag to select a specific authenticated account. If only one profile exists, the flag can be omitted and the default profile is used.

Why does gmail export to PDF fail on my machine?▼

The export command requires Chrome, Chromium, or Microsoft Edge installed locally to render the message as PDF. On headless CI runners without a browser, use gmail get --format html instead and convert with another tool.

Related Skills

Explore More Personal & Entrepreneur Skills→
nsheapsnsheaps
3

op

Manage and retrieve 1Password secrets via the op CLI.

Community
Intermediate
Sim-hub22Sim-hub22

resend-inbound

Verify Resend webhook signatures and retrieve email content and attachments.

Community
Intermediate
zai-orgzai-org
588

rss-digest

Fetch RSS entries, triage top items, and generate concise summaries.

Official
Intermediate
reasonlayerreasonlayer

add-gmail

Integrate Gmail with NanoClaw to read and send emails via Google APIs.

Official
Advanced