Agent skill · Backend & API

gmail-automation

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

Nick44,086★ · +407/wk · 1 repos on radarProfile →
claude-codecodexcursorMIT
Install
npx skills add sickn33/agentic-awesome-skills --skill gmail-automation --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 5 KB
Bundled scripts: none
Version: 1.0
Declared author: sanjay3290
Path: skills/gmail-automation/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 44,414 · +328 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Gmail Lightweight Gmail integration with standalone OAuth authentication. No MCP server required. > **⚠️ Requires Google Workspace account.** Personal Gmail accounts are not supported. ## When to Use - You need to search, read, or send Gmail messages from the command line without an MCP server. - You are automating inbox workflows for a Google Workspace account. - You want a lightweight Gmail integration backed by standalone OAuth scripts. ## First-Time Setup Authenticate with Google (opens browser): ```bash python scripts/auth.py login ``` Check authentication status: ```bash python scripts/auth.py status ``` Logout when needed: ```bash python scripts/auth.py logout ``` ## Commands All operations via `scripts/gmail.py`. Auto-authenticates on first use if not logged in. ### Search Emails ```bash # Search with Gmail query syntax python scripts/gmail.py search "from:someone@example.com is:unread" # Search recent emails (no query returns all) python scripts/gmail.py search --limit 20 # Filter by label python scripts/gmail.py search --label INBOX --limit 10 # Include spam and trash python scripts/gmail.py search "subject:important" --include-spam-trash ``` ### Read Email Content ```b

What's inside
Steps it walks through
  1. When to Use
  2. First-Time Setup
  3. Commands
  4. Search Emails
  5. Read Email Content
  6. Send Emails
  7. Draft Management
  8. Modify Messages (Labels)
  9. List Labels
  10. Gmail Query Syntax
  11. Common Label IDs
  12. Token Management
  13. Limitations
Commands it runs
python scripts/auth.py login
python scripts/auth.py status
python scripts/auth.py logout
Search with Gmail query syntax
python scripts/gmail.py search "from:someone@example.com is:unread"
Search recent emails (no query returns all)
python scripts/gmail.py search --limit 20
Filter by label
python scripts/gmail.py search --label INBOX --limit 10
Include spam and trash
More from agentic-awesome-skills
All skills →
About this skill
What does the gmail-automation skill do?

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

How do I install it?

Run `npx skills add sickn33/agentic-awesome-skills --skill gmail-automation --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going