gmail-reader

Read and summarize Gmail messages and threads via the Gmail API.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ngochuy13/intern-dev --skill gmail-reader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail-reader
Source: https://github.com/ngochuy13/intern-dev/tree/main/skills/gmail-reader
Command: npx skills add https://github.com/ngochuy13/intern-dev --skill gmail-reader

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of quickly finding important emails and understanding their contents without manually scanning your inbox.

Core Features & Use Cases

  • Read-only Gmail searching: Use Gmail search operators to locate messages by sender, subject, keywords, labels, and time ranges.
  • Thread and message retrieval: Open a specific message or pull the full thread content for context.
  • Unread listing and inbox summarization: Surface unread emails and produce a readable summary of what’s new.

Quick Start

Tell the Gmail reader to search your inbox for unread messages from a specific sender and summarize the most relevant results.

Frequently Asked Questions about gmail-reader

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

FAQPage Schema
How do I search and summarize unread Gmail messages without opening my inbox?

You can search and summarize unread Gmail messages by applying Gmail search operators to filter by sender, subject, or time range. The tool retrieves and decodes message bodies, presenting a formatted summary of unread inbox results.

What's the best way to find specific emails using Gmail search operators?

The best way to find specific emails is using Gmail search operators to locate messages by sender, subject, keywords, labels, and time ranges. This read-only approach filters inbox content and returns formatted summaries of matching results.

Do I need OAuth to read Gmail threads and message content?

Yes, you need OAuth Bearer authorization with the gmail.readonly scope to read Gmail threads and message content. This read-only access allows the tool to decode base64url message bodies and present clean formatted text.

Can I use Gmail API to pull full thread content for context?

Yes, you can use the Gmail API to pull full thread content for context. The tool retrieves specific messages or entire threads, decodes the base64url message bodies, and presents the full content with robust handling for zero results.

What happens when Gmail API token expires during inbox search?

When a Gmail API token expires during an inbox search, the tool provides robust handling for expired tokens. It ensures the process stops gracefully rather than failing mid-search, maintaining secure read-only access boundaries.

How do I list unread emails from a specific sender for a defined timeframe?

To list unread emails from a specific sender for a defined timeframe, apply Gmail search operators combining sender, unread status, and date range. The tool surfaces these emails and produces a readable summary of the new messages.