skills.rest
KISHOR403
KISHOR403COMMUNITY
Explore all skills by this author →
Website𝕏@kishor_gogoi8GitHub

gmail

Search and retrieve Gmail messages with flexible queries and output as Markdown or JSON.

Updated Apr 16, 2026
Search Tags:#api#oauth#search#gmail#command-line#attachments#gmail-api
One-click install
npx skills add https://github.com/KISHOR403/claude-skills --skill gmail-kishor403
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/KISHOR403/claude-skills/tree/main/gmail
Command: npx skills add https://github.com/KISHOR403/claude-skills --skill gmail-kishor403

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill enables you to search, fetch, and download Gmail messages using a script and Gmail API, streamlining email discovery and data retrieval.

Core Features & Use Cases

  • Free-text search with Gmail query syntax to locate messages across your account.
  • Filter by sender, recipient, subject, label, and date ranges; include or exclude unread, starred, and attachments.
  • Retrieve message metadata or full body data, with option to download attachments and list labels for quick organization.

Quick Start

Run the Gmail search script to authenticate, then execute a sample query like "project update" to see results.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I search and fetch Gmail messages using the command line?▼

To search and fetch Gmail messages, run a local script that authenticates via OAuth and executes free-text queries or filters through the Gmail API, outputting results as Markdown or JSON.

Do I need OAuth credentials to retrieve email metadata via the Gmail API?▼

Yes, you must configure OAuth credentials and specify Gmail API scopes to authenticate your account before retrieving message metadata or downloading attachments.

Can I filter Gmail queries by sender, date range, and attachment status?▼

Yes, Gmail API queries support filtering by sender, recipient, subject, label, and date ranges, with options to include or exclude unread, starred, and attachment metadata.

Does this Gmail search script support downloading attachments and outputting JSON?▼

Yes, the script supports downloading attachments and retrieving full message body data, outputting results in either CLI Markdown or JSON formats.

What Python dependencies are required to run a Gmail API search script?▼

You need to install google-api-python-client, google-auth-httplib2, google-auth-oauthlib, and google-auth to handle Gmail API calls and OAuth authentication.

What is the best way to automate email discovery across a Gmail account?▼

The best way to automate email discovery is using a Gmail API script to execute free-text queries, apply filters, and fetch message data programmatically.

Related Skills

Explore More Software Engineering Skills→
abdullahbeamabdullahbeam
2

google-integration

Authenticate once across Google Workspace services via unified OAuth.

Community
Advanced
eugenelimeugenelim
15

msg-to-markdown

Convert Outlook .msg email files into structured Markdown output.

Community
Intermediate
aayushsoamaayushsoam
1

google-workspace

Manage Gmail, Calendar, Drive, Sheets, and Docs via the gws CLI.

Community
Intermediate
e252828e252828

imap-smtp-email

Automate email reading, sending, and mailbox management via IMAP/SMTP.

Community
Intermediate