sase_gmail

Inspect Gmail messages and retrieve attachments via the gog CLI.

5|Updated Dec 6, 2021
One-click install
npx skills add https://github.com/bbugyi200/dotfiles --skill sase-gmail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sase_gmail
Source: https://github.com/bbugyi200/dotfiles/tree/main/home/dot_codex/skills/sase_gmail
Command: npx skills add https://github.com/bbugyi200/dotfiles --skill sase-gmail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gog, jq.

What problem does it solve?

This skill provides a safe, read-only interface for inspecting personal Gmail messages without the risks associated with raw API access or manual browser navigation.

Core Features & Use Cases

  • Safe Inspection: Search, retrieve, and read email content and threads using standardized, read-only commands.
  • Attachment Handling: Securely list and download email attachments to a dedicated local scratch directory.
  • Use Case: Quickly search for recent emails from a specific sender or retrieve details from a thread to summarize information for a project without ever needing to open a web browser or risk accidental email modification.

Quick Start

Use the sase_gmail skill to search for and display the content of the most recent emails from the last two weeks.

Frequently Asked Questions about sase_gmail

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

FAQPage Schema
How do I read Gmail messages safely without risking accidental account modification?

You can read Gmail messages safely using a read-only interface that restricts actions to message inspection and attachment retrieval. This approach prevents account mutation by strictly prohibiting unauthorized API usage.

What's the best way to search and download email attachments from my personal Gmail?

The best way to download email attachments is using a read-only Gmail interface that securely lists and retrieves files to a dedicated local scratch directory. This method ensures sanitized data handling during extraction.

Do I need to install gog and jq to retrieve Gmail content?

Yes, you need both the gog utility and jq to retrieve Gmail content. The gog tool provides the interface for message inspection, while jq is required for JSON processing to ensure safe, sanitized data handling.

Can I use this approach to search recent emails for project research without a browser?

Yes, you can search recent emails for project research without opening a web browser. The interface facilitates secure email data extraction, allowing you to retrieve message details and thread content for task context.

What are the limitations of using a read-only Gmail interface?

The primary limitation of a read-only Gmail interface is that it strictly prohibits account mutation, meaning you cannot send, delete, or modify emails. It is designed solely for safe message inspection and attachment retrieval.