skills.rest
Immanuel-Aristotle
Immanuel-AristotleCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gmail-automation

Automate Gmail search, read, send, and label workflows via CLI with OAuth.

Updated Apr 27, 2026
Search Tags:#automation#authentication#oauth#cli#gmail#labels#gmail-api
One-click install
npx skills add https://github.com/Immanuel-Aristotle/agents --skill gmail-automation-immanuel-aristotle
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail-automation
Source: https://github.com/Immanuel-Aristotle/agents/tree/main/skills/gmail-automation
Command: npx skills add https://github.com/Immanuel-Aristotle/agents --skill gmail-automation-immanuel-aristotle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Lightweight Gmail integration with standalone OAuth authentication. No MCP server required.

Core Features & Use Cases

  • Search, read, and send Gmail messages from the CLI.
  • Manage drafts and labels, including archiving and starring.
  • Works with Google Workspace accounts and uses a simple OAuth flow for authentication.

Quick Start

Authenticate with Google in your browser and then run the Gmail CLI commands to perform searches, reads, and sends.

Frequently Asked Questions about gmail-automation

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

FAQPage Schema
How do I automate Gmail access from the command line without an MCP server?▼

You can automate Gmail access from the command line by using standalone OAuth authentication. This approach removes the need for an MCP server by directly handling login and storing tokens in the system keyring with automatic refresh.

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

Yes, you can manage Gmail labels and drafts using a CLI. The automation script supports searching, reading, and sending messages, alongside managing drafts, archiving, starring, and automating label-based workflows.

Does standalone OAuth work with Google Workspace accounts for Gmail automation?▼

Yes, standalone OAuth works with Google Workspace accounts for Gmail automation. You authenticate with Google in your browser, allowing the CLI to securely access and manage your Workspace email.

How does the CLI handle Gmail authentication tokens?▼

The CLI handles Gmail authentication tokens by storing them securely in the system keyring. It also features automatic token refresh to maintain continuous access without requiring repeated manual logins.

What is the best way to search and read Gmail messages via the Gmail API?▼

The best way to search and read Gmail messages via the Gmail API is using a dedicated Python entry point script. It automates these operations directly from the command line after a simple browser-based OAuth login.

Are there limitations to automating Gmail workflows with standalone OAuth?▼

Automating Gmail workflows with standalone OAuth relies on a scripts-based entry point, meaning it is bound by CLI constraints and standard Gmail API limits. It does not require an MCP server, focusing strictly on label-based workflows and message management.

Related Skills

Explore More Software Engineering Skills→
sanjay3290sanjay3290
392

google-chat

List Google Chat spaces, send messages, and read conversations via OAuth.

Community
Intermediate
PorkbuttsPorkbutts
1

gws-gmail-watch

Monitor Gmail for new emails and stream them as NDJSON.

Community
Intermediate
andrioidandrioid
8

mise-tasks

Organize and execute bash-based mise tasks from the scripts/ directory.

Community
Intermediate
LaurentPRAT-DBLaurentPRAT-DB

google-auth

Manage unified authentication for Google Workspace APIs using gcloud CLI and Application Default Credentials.

Community
Intermediate