gmail
Interact with Gmail - search emails, read messages, send emails, create drafts, and manage labels. Use when user asks to: search email, read email, send email, create email draft, mark as read, archive email, star email, or manage Gmail labels. Lightweight alternative to full Google Workspace MCP se
By sanjay3290 · 489 installs
npx skills add sanjay3290/ai-skills --skill gmail
Source repository · Upstream listing
Gmail
Lightweight Gmail integration with standalone OAuth authentication. No MCP server required.
⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported.
First Time Setup
Authenticate with Google (opens browser):
Check authentication status:
Logout when needed:
Commands
All operations via scripts/gmail.py . Auto authenticates on first use if not logged in.
Search Emails
Read Email Content
Send Emails
Draft Management
Modify Messages (Labels)
List Labels
Gmail Query Syntax
Gmail supports powerful search operators:
Query Description
from:user@example.com Emails from a specific sender
to:user@example.com Emails to a specific recipient
subject:meeting Emails with "meeting" in subject
is:unread Unread emails
is:starred Starred emails
is:important Important emails
has:attachment Emails with attachments
after:2024/01/01 Emails after a date
before:2024/12/31 Emails before a date
newer than:7d Emails from last 7 days
older than:1m Emails older than 1 month
label:work Emails with a specific label
in:inbox Emails in inbox
in:sent Sent emails
in:trash Trashed emails
Combine with AND (space), OR, or (NOT):
Common Label IDs
Label ID
Inbox INBOX
Sent SENT
Drafts DRAFT
Spam SPAM
Trash TRASH
Starred STARRED
Important IMPORTANT
Unread UNREAD
Token Management
Tokens stored securely using the system keyring:
macOS : Keychain
Windows : Windows Credential Locker
Linux : Secret Service API (GNOME Keyring, KDE Wallet, etc.)
Service name: gmail skill oauth
Tokens automatically refresh when expired using Google's cloud function.