gmail-skill

Automate Gmail send, read, search, label, and draft tasks via CLI.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/3172973615/skill-explore --skill gmail-skill-3172973615
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail-skill
Source: https://github.com/3172973615/skill-explore/tree/main/skillsbench_subset/tasks/scheduling-email-assistant/environment/skills/gmail-skill
Command: npx skills add https://github.com/3172973615/skill-explore --skill gmail-skill-3172973615

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Gmail management can be tedious and error-prone when performed manually. This skill provides a token-efficient CLI-based interface to send, read, search, label, and draft Gmail messages, reducing friction and enabling automation.

Core Features & Use Cases

  • Send emails with HTML support, CC/BCC, and custom headers
  • Search and read messages with thread context
  • Manage labels (list, create, add, remove)
  • Manage drafts (create, update, send, delete)
  • Multi-account support via --account for switching Gmail accounts

Quick Start

Install dependencies, authenticate with Google, and run a script such as node gmail-send.js to send an email.

Frequently Asked Questions about gmail-skill

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

FAQPage Schema
How do I automate sending HTML email via Gmail from the command line?

This Skill automates Gmail tasks via a CLI interface, allowing you to send emails with HTML support, CC, and BCC. It requires Google OAuth credentials to authenticate API requests and executes scripts to dispatch messages directly from the command line.

Can I manage multiple Gmail accounts using a single CLI script?

Yes, you can manage multiple Gmail accounts by using the --account switch within the CLI script. This feature allows you to seamlessly alternate between authenticated Google OAuth profiles to read, search, or send emails across different identities.

How do I search and read Gmail messages with thread context programmatically?

You can search and read Gmail messages with thread context by executing a CLI command that queries the Gmail API. The script retrieves matching conversations and returns the structured message data in JSON format for programmatic consumption.

What is required to manage Gmail labels and drafts via the command line?

Managing Gmail labels and drafts via the command line requires Google OAuth credentials for authentication and the googleapis dependency. Once authenticated, you can run CLI scripts to create, update, delete, or organize drafts and apply labels to messages.

Does this Gmail CLI automation approach support custom headers in outgoing emails?

Yes, this Gmail CLI automation approach supports custom headers in outgoing emails alongside standard HTML content, CC, and BCC recipients. You define these headers within the script payload before the Gmail API dispatches the message.

What are the limitations of using a CLI for Gmail automation instead of manual management?

Using a CLI for Gmail automation requires initial setup with Google OAuth credentials and dependency installation, but it limits visual feedback to JSON-formatted outputs. It is best suited for token-efficient scripted workflows rather than visual inbox triage.