skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author →
GitHub

gmail

Read, send, search, and manage Gmail emails via the Gmail API with OAuth authentication.

Updated Jan 22, 2026
Search Tags:#automation#oauth#email#inbox#gmail#draft#google api
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill gmail-fahadimdad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/google/gmail
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill gmail-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-auth, google-auth-oauthlib, google-api-python-client, and includes scripts (resource) components.

What problem does it solve? Managing email manually across reading, replying, forwarding, and organizing messages is repetitive and time-consuming, especially when you want an AI assistant to handle inbox workflows without risking accidental sends. ## Core Features & Use Cases - Read & Search Emails: List, search, and read inbox messages using Gmail search syntax like from:, subject:, and is:unread. - Safe Sending with Draft-First Workflow: Send, reply, and forward operations always create a draft first and require explicit confirmation before anything is sent. - Inbox Management: Create drafts, manage labels, archive, trash, and mark messages as read or unread. - Use Case: Ask the assistant to check unread emails from a client, summarize them, and draft a reply that you review in Gmail before sending. ## Quick Start Ask the assistant to list your unread emails and draft a reply to the most recent one for your review.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I send an email with the Gmail API in Python?▼

Build a MIMEText message, base64-encode it, and call users().messages().send with the authenticated Gmail service. This skill wraps that flow in a send command that first creates a draft and asks for confirmation before sending.

How do I search Gmail emails from the command line?▼

Use the search command with standard Gmail search operators like from:, subject:, is:unread, has:attachment, after:, and label:. The script passes the query to the Gmail API messages.list endpoint and returns matching email summaries.

What credentials are needed for Gmail API access?▼

You need OAuth credentials from Google Cloud Console with the Gmail API enabled, configured as a Desktop app. Store GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_PROJECT_ID in a .env file, then run the google_auth.py login flow.

Can the skill send emails without my confirmation?▼

No. All send, reply, and forward operations create a draft first and require explicit confirmation before sending. You can choose to send immediately, keep the draft for review in Gmail, or cancel and delete the draft.

Why does Gmail authentication fail with missing dependencies?▼

The scripts require google-auth, google-auth-oauthlib, and google-api-python-client installed via pip. If the pre-flight check returns exit code 2, install those packages and verify your OAuth credentials are present in the .env file.

Related Skills

Explore More Personal & Entrepreneur Skills→
TerrifiedBugTerrifiedBug

add-skill-gmail

Configure Gmail OAuth scopes and sync credentials for NanoClaw agents.

Community
Advanced
Sim-hub22Sim-hub22

resend-inbound

Verify Resend webhook signatures and retrieve email content and attachments.

Community
Intermediate
vikingokftvikingokft

persona-sales-ops

Coordinate deals, calendars, and client communications across Gmail, Calendar, Sheets, and Drive.

Official
Intermediate
Kastalien-ResearchKastalien-Research

himalaya

Manage emails from the terminal using IMAP and SMTP backends.

Official
Intermediate