gmail

List, search, read, and reply to Gmail emails with attachments.

9|1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/flaz78/9Lives --skill gmail-flaz78
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/flaz78/9Lives/tree/main/workspace/skills/gmail
Command: npx skills add https://github.com/flaz78/9Lives --skill gmail-flaz78

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill eliminates the manual effort of browsing, searching, reading, and sending emails in Gmail by letting you handle common email workflows through structured tool calls while keeping you in control.

Core Features & Use Cases

  • List recent emails: Retrieve recent messages from a chosen mailbox with optional filters like unread-only.
  • Read full email content: Fetch complete message text plus a structured list of attachments (name/type/size) and optionally mark as read.
  • Search and act on results: Use Gmail queries to find relevant emails (e.g., unread invoices) and then read, reply, or download attachments.
  • Send and reply safely with attachments: Send new emails or reply within a thread, supporting attachments via server file paths or base64 content.
  • Extract attachments: Download a specific attachment from a received email to the filesystem or return it as base64.

Quick Start

Use the gmail skill to search for unread messages with query "from:mario subject:fattura is:unread", then read the most relevant result and extract its attachments for review.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I automate searching and reading unread Gmail messages via IMAP?

Automating Gmail inbox management is done by listing, searching, and reading unread messages through structured tool calls via IMAP. You retrieve recent messages from a chosen mailbox using optional filters like unread-only to fetch complete message text.

Can I send emails with attachments automatically using SMTP and an App Password?

Yes, sending emails with attachments via SMTP requires a Google App Password. The workflow supports attachments via server file paths or base64 content, and it enforces safe usage by asking for explicit user confirmation before sending messages.

What do I need to set up to connect my Gmail account for automated inbox workflows?

To connect your Gmail account, you need Google Gmail credentials configured for SMTP and IMAP access using an App Password. This authentication setup enables automated tool calls to securely list, search, read, and reply to emails.

How do I extract and download email attachments from specific Gmail search results?

Extracting email attachments from Gmail search results involves using queries to find relevant emails, then downloading a specific attachment to the filesystem or returning it as base64 content. This allows redistributing files like invoices from unread messages.

Does sending automated Gmail replies require confirmation before dispatching messages?

Yes, sending automated Gmail replies requires explicit user confirmation before dispatching messages. This safety mechanism ensures you remain in control of outbound communication when automating thread replies or sending new emails with attachments.