skills.rest
jeffvincent
jeffvincentCOMMUNITY
Explore all skills by this author →
GitHub

gmail-manager

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

5|Updated Nov 26, 2025
Search Tags:#oauth#CLI#email#gmail#token#account-management
One-click install
npx skills add https://github.com/jeffvincent/claude-config --skill gmail-manager
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail-manager
Source: https://github.com/jeffvincent/claude-config/tree/main/skills/gmail-skill
Command: npx skills add https://github.com/jeffvincent/claude-config --skill gmail-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires googleapis, minimist, open, mailcomposer, and includes scripts (resource) components.

What problem does it solve?

This Skill provides token-efficient Gmail management through CLI scripts that support sending, reading, searching, labeling, and drafting emails across one or more accounts with minimal prompts and secure storage.

Core Features & Use Cases

  • Send emails with optional CC/BCC, HTML content, and custom headers.
  • Search, read, and organize emails across configured accounts.
  • Manage labels and drafts; multi-account OAuth setup with token storage.

Quick Start

Install dependencies, run OAuth setup to authorize Gmail access, then start issuing commands such as:

Frequently Asked Questions about gmail-manager

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

FAQPage Schema
How do I send emails via CLI with Gmail OAuth authentication?▼

Gmail-manager exposes CLI scripts that send emails securely using OAuth-based authentication, eliminating the need for app passwords. After authorizing your Gmail account through the OAuth setup, you can send emails with recipients, subject, body, and optional CC/BCC directly from the command line.

Can I search and read emails across multiple Gmail accounts from the CLI?▼

Yes. Gmail-manager supports multi-account setups with account-scoped operations and token management. Configure each account during OAuth setup, then issue search and read commands that target specific accounts or operate across all configured accounts simultaneously.

What's the token-efficient way to manage Gmail labels and drafts via CLI?▼

Gmail-manager minimizes API calls through token-efficient CLI scripts that manage labels, drafts, and common tasks like replying to unread messages. Operations return JSON output for integration into scripts and workflows, reducing redundant requests.

Do I need to store Gmail tokens locally, and how does gmail-manager handle security?▼

Gmail-manager securely stores OAuth tokens locally during setup so you don't re-authenticate for each command. Tokens are managed per account and kept on your machine, enabling unattended CLI operations while maintaining security.

Can gmail-manager handle HTML email content and advanced search filters?▼

Yes. Gmail-manager supports sending emails with HTML content and custom headers, plus advanced search operations to filter by sender, date, and label. These features enable complex email workflows directly from the CLI without opening Gmail.

Is gmail-manager suitable for automation in Claude Code workflows?▼

Gmail-manager is designed for Claude Code workflows and multi-account setups. It outputs JSON and logs actions, making it ideal for integrating email operations into automated scripts and agent-driven processes.

Related Skills

Explore More Content & Communication Skills→
badlogicbadlogic
2.3k

gmcli

Manage Gmail from the terminal with search, read, and send operations.

Community
Intermediate
chunkydotdevchunkydotdev
2

inbound-processing

Parse inbound email webhooks from Postmark, SendGrid, Mailgun, and AWS SES.

Community
Advanced
kunwl123456kunwl123456
26

log-archiver

Archive log files older than a specified number of days.

Community
Basic
zocomputerzocomputer
45

google-direct-oauth

Manage OAuth 2.0 authentication for Google Calendar and Gmail APIs.

Official
Advanced