gmail

Manage Gmail inboxes programmatically via the Google Gmail API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines Gmail inbox management by enabling read, triage, reply, and sending actions directly from Claude Code, reducing manual context switching and response time.

Core Features & Use Cases

  • List inbox by thread with metadata and unread status for quick triage.
  • Read, compose, and send emails with proper threading and From/Reply-To handling.
  • Create and apply filters to auto-organize mail and reduce inbox noise.
  • Use cases include sales outreach, support triage, and executive inbox management.

Quick Start

Configure credentials and run the list command to view your inbox.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I automate Gmail inbox triage and replies using Claude?

Automate Gmail inbox triage by using Claude Code to programmatically list, read, filter, and reply to emails. This requires configuring Google Gmail API credentials and invoking a Python CLI script to manage daily email workflows and batch operations.

Can I create Gmail filters to auto-organize my inbox via Claude Code?

Yes, you can create and apply Gmail filters via Claude Code to auto-organize mail and reduce inbox noise. The Skill enables programmatic filter management to streamline sales outreach, support triage, and personal productivity workflows.

How do I send emails with proper threading and reply-to handling from a CLI?

Send emails with proper threading and From/Reply-To handling by invoking the Python-based CLI script located at ~/.config/gmail/gmail.py. This script uses the RAWGROWTHOS_DIR prefix and Google API tokens to compose, thread, and dispatch messages.

Do I need Google API credentials to manage my inbox through Claude?

Yes, managing your inbox through Claude requires Google Gmail API credentials for authentication. You must complete token handling setup before executing list, read, send, or batch label operations via the local Python script.

What is the best way to batch manage email labels for executive inbox workflows?

The best way to batch manage email labels for executive workflows is using this Skill's programmatic CLI interface. It applies batch label operations and threading metadata to quickly triage high-volume inboxes directly from Claude Code.

Why are my Gmail API tokens not working when invoked through the CLI script?

Gmail API tokens may fail if the Python script is not invoked with the proper RAWGROWTHOS_DIR prefix or if credential configuration is incomplete. Ensure Google API authentication is valid before attempting inbox listing or sending actions.