gmail

Read and search Gmail messages via the Gmail API with OAuth authentication.

1|Updated May 12, 2018
One-click install
npx skills add https://github.com/tbroadley/dotfiles --skill gmail-tbroadley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/tbroadley/dotfiles/tree/main/claude/skills/gmail
Command: npx skills add https://github.com/tbroadley/dotfiles --skill gmail-tbroadley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables reading and searching Gmail messages via the Gmail API, allowing you to inspect inbox content, perform targeted searches, and view email threads without leaving your workflow.

Core Features & Use Cases

  • Read and search Gmail messages using the Gmail API.
  • Retrieve full messages or metadata and view threads for context.
  • Use cases include quickly checking unread emails, finding messages from a specific sender, or locating important conversations.

Quick Start

Use the Gmail skill to fetch your most recent unread messages by authenticating with OAuth and issuing an API call like: curl -s "https://gmail.googleapis.com/gmail/v1/users/me/messages" -H "Authorization: Bearer ${ACCESS_TOKEN}"

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I read and search Gmail messages through the API?

You can read and search Gmail messages by authenticating with OAuth and issuing API calls to retrieve full message data or metadata. This allows you to inspect inbox content and locate specific conversations programmatically.

Can I retrieve Gmail email threads for conversation context?

Yes, you can retrieve Gmail email threads to view conversation context. The API supports fetching full messages or metadata with optional thread information, allowing you to follow complete conversations.

Do I need OAuth to access Gmail inbox status and unread emails?

Yes, OAuth-based authentication is required to access Gmail inbox status and unread emails. You must authorize API access to user data using an access token before retrieving messages.

What's the best way to locate specific conversations in Gmail programmatically?

The best way to locate specific conversations programmatically is using the Gmail API to perform targeted searches. You can find messages from specific senders or locate important conversations without leaving your workflow.

Does the Gmail API support retrieving message metadata without full content?

Yes, the Gmail API supports retrieving message metadata without full content. You can fetch optional thread information and metadata to check inbox status efficiently without downloading entire messages.

Why use the Gmail API instead of manual inbox checking for finding messages from a specific sender?

Using the Gmail API automates finding messages from a specific sender and checking unread emails without leaving your workflow. It enables programmatic reading and searching of Gmail messages, saving time compared to manual inbox checking.