skill-gmail-api

Gmail API skill for email operations via CLI. Supports reading, drafting, sending, archiving, labeling, and batch operations. Use when user needs to: read emails, create/send drafts, reply to messages, archive/trash messages, manage labels, or perform bulk email operations.

Installation

$ npx skills add smithery/tmustier --skill skill-gmail-api

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared

Cursor Not declared

Codex Not declared

GitHub Copilot Not declared

Windsurf Not declared

Gemini CLI Not declared

Cline Not declared

OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

skill md SKILL.md 1,485 B

docs SUMMARY.md 298 B

SKILL.md

Gmail API Skill

Quick Reference

# Read
scripts/gmail.py read --limit 10
scripts/gmail.py read --query "is:unread" --full
scripts/gmail.py get --id MSG_ID

# Draft & Send  
scripts/gmail.py draft --to "[email protected]" --subject "Hi" --body "Hello"
scripts/gmail.py draft --reply-to MSG_ID --body "Thanks!"
scripts/gmail.py send --draft-id DRAFT_ID
scripts/gmail.py send --to "[email protected]" --subject "Hi" --body "Hello"

# Manage
scripts/gmail.py archive --id MSG_ID
scripts/gmail.py trash --id MSG_ID
scripts/gmail.py star --id MSG_ID
scripts/gmail.py mark-read --id MSG_ID

# Batch
scripts/gmail.py batch-archive --query "from:newsletters@"
scripts/gmail.py batch-mark-read --query "is:unread from:notifications@"

Run scripts/gmail.py --help or scripts/gmail.py COMMAND --help for options.

Full command reference: See [references/commands.md](references/commands.md)

Setup

Create OAuth credentials at Google Cloud Console
Copy credentials.example.json to credentials.json and add your client_id/secret
First run opens browser for OAuth consent