google-gmail

Read, search, and manage Gmail messages and threads via REST.

13|1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/AceDataCloud/Skills --skill google-gmail-acedatacloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-gmail
Source: https://github.com/AceDataCloud/Skills/tree/main/skills/google-gmail
Command: npx skills add https://github.com/AceDataCloud/Skills --skill google-gmail-acedatacloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you read, search, triage, label, archive, and send Gmail messages and threads without manually navigating your mailbox.

Core Features & Use Cases

  • Inbox reading and summarization: Pull unread messages, inspect a specific thread, and summarize content or attachment context.
  • Search and triage: Filter by Gmail query or label, list messages, and download attachments when needed.
  • Safe message modification and sending: Apply label/archive/trash actions and draft or send replies with explicit confirmation for destructive actions.

Quick Start

Ask: "Read my unread inbox from the last 7 days, summarize each thread, and tell me which ones need a reply."

Frequently Asked Questions about google-gmail

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

FAQPage Schema
How do I automatically summarize Gmail threads and find unread inbox messages?

To summarize Gmail threads and read unread messages, this Skill pulls unread inbox messages, inspects specific threads, and provides thread summarization using Gmail v1 REST endpoints. You can filter and summarize unread emails from specific timeframes.

Do I need an OAuth token to search Gmail and download email attachments?

Yes, searching Gmail and downloading attachments requires a Gmail OAuth bearer token in $GOOGLE_GMAIL_TOKEN. You need gmail.readonly plus optional gmail.modify and gmail.send scopes configured to authenticate and interact with your mailbox.

Can I safely apply labels, archive, or trash emails without accidental deletion?

You can safely apply labels, archive, or trash emails because this Skill enforces explicit confirmation before destructive writes. This ensures modifications to your Gmail threads are reviewed before any label, archive, or trash action is finalized.

What's the best way to draft and send outbound email from Gmail using API scopes?

The best way to draft and send outbound email is using the optional gmail.send scope and gws endpoints. This Skill handles message drafting and sending replies, requiring the appropriate OAuth scopes to compose and dispatch new emails.

How does Gmail inbox triage work when filtering by labels and queries?

Gmail inbox triage works by filtering messages using Gmail queries or labels to list relevant emails. This Skill reads and searches your mailbox, performing triage to organize threads, download attachments, and identify unread messages needing a reply.