skills.rest
seungwonme
seungwonmeCOMMUNITY
Explore all skills by this author →
Website𝕏@aidensystemsGitHub

gmail

Read, search, and send emails across multiple Gmail accounts via CLI.

Updated Aug 27, 2026
Search Tags:#api#oauth#cli#email#gmail#labels#multi-account
One-click install
npx skills add https://github.com/seungwonme/.claude --skill gmail-seungwonme
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/seungwonme/.claude/tree/main/skills/gmail
Command: npx skills add https://github.com/seungwonme/.claude --skill gmail-seungwonme

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-auth, google-auth-oauthlib, google-api-python-client, pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Managing email across multiple Gmail accounts manually is error-prone and time-consuming. This skill provides a unified CLI to read, search, send, and organize emails using the Gmail API with per-account tokens and offline caching.

Core Features & Use Cases

  • Multi-account Gmail access for reading, listing, sending, drafting, and label management.
  • Local caching and quota management with exponential backoff for reliable operation.
  • Batch operations and CLI workflows to compose and send with optional attachments.

Quick Start

Configure accounts.yaml, authenticate accounts with setup_auth.py, then run the provided scripts to read or send emails.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I manage multiple Gmail accounts from the command line?▼

This Skill provides a unified CLI interface that connects to the Gmail API, allowing you to manage multiple Gmail accounts from the command line. It relies on per-account OAuth tokens stored in accounts/*.json to read, send, and organize emails.

How do I authenticate multiple Gmail accounts for API access?▼

You authenticate multiple Gmail accounts for API access by configuring accounts.yaml and running the setup_auth.py script. This generates per-account tokens in accounts/*.json required for offline access and CLI operations.

Can I manage Gmail labels and drafts using a CLI?▼

Yes, you can manage Gmail labels and drafts using the provided CLI workflows. The interface supports label management and creating drafts, alongside reading, searching, and sending emails across configured accounts.

Does this Gmail CLI handle API rate limits and quota management?▼

Yes, this Gmail CLI handles API rate limits and quota management using local caching and exponential backoff retry logic. This ensures reliable operation and prevents failures when hitting API quotas during batch operations.

What Python dependencies are required for Gmail API integration?▼

The required Python dependencies for this Gmail API integration are google-auth, google-auth-oauthlib, google-api-python-client, and pyyaml. These libraries manage authentication flows, API requests, and YAML configuration parsing.

Related Skills

Explore More Software Engineering Skills→
jeffvincentjeffvincent
5

gmail-manager

Manage Gmail accounts via CLI scripts for sending, searching, reading, labeling, and drafting emails.

Community
Advanced
acrocaacroca

mailescrow

Queue outbound emails for human approval before SMTP sending.

Community
Advanced
pinion05pinion05
3

gmail

Search and fetch Gmail messages via the Gmail API with filters and Markdown or JSON output.

Community
Intermediate
ldzhhxxldzhhxx
1

himalaya

Manage emails via the Himalaya CLI for IMAP/SMTP.

Community
Intermediate