Can I search for unread or starred emails?

Absolutely. You can include 'is:unread' or 'is:starred' in your search query to target specific message statuses.

Can I view the actual content of the emails found?

Yes, by including the '--include-body' flag in the command, Claude can retrieve a preview of the email content for you.

Is it possible to filter by date?

Yes, you can use operators like 'after:YYYY/MM/DD' or 'before:YYYY/MM/DD' to find emails within a specific timeframe.

How many emails can I retrieve at once?

The skill defaults to 20 results, but you can customize this using the '--max' option followed by your desired number.

How do I search for emails from a specific sender?

You can use the native Gmail syntax 'from:user@example.com' within the search query to filter results by a specific sender.

Gmail Search

Name: Gmail Search
Author: shiiman

byshiiman

•

Productivity & Workflow

Searches Gmail messages using native query syntax to find specific emails, attachments, and conversations directly within Claude.

The Gmail Search skill enables Claude to interact with your Google Workspace by executing advanced search queries across your inbox. By leveraging Gmail's native search operators—such as sender filters, date ranges, and attachment status—this skill allows users to retrieve specific information from past communications, locate important documents, and track project threads without leaving the terminal environment. It is an essential tool for professionals who need to bridge the gap between their development workflow and their communication history.

Key Features

01Optional email body preview extraction for context retrieval

02Identifies emails with attachments or specific labels

03Supports advanced Gmail query syntax including from, to, and subject filters

04Configurable result limits to manage output volume

052 GitHub stars

06Filters by date ranges using after: and before: operators

Use Cases

01Summarizing recent conversations from a project stakeholder to get up to speed

02Locating misplaced attachments or documents mentioned in previous threads

03Finding specific technical requirements or client feedback sent via email

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add shiiman/claude-code-plugins gmail-search

For use in Claude.ai and ChatGPT

Download Skill