gmail

Automate Gmail search, read, send, draft, and label operations via Python.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/haydenso/gmail-skill --skill gmail-haydenso
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/haydenso/gmail-skill/tree/main
Command: npx skills add https://github.com/haydenso/gmail-skill --skill gmail-haydenso

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires keyring, and includes scripts (resource) components.

What problem does it solve?

This Skill automates Gmail management by enabling search, read, send, draft, and label operations through a lightweight Python client.

Core Features & Use Cases

  • Gmail search and retrieval using Gmail query syntax to locate messages quickly.
  • Read, compose, and send emails with support for CC/BCC and HTML content.
  • Draft management and label operations (archive, mark read/unread, star) to streamline inbox workflows.
  • Use Case: Automate daily email triage by automatically searching for priority messages, generating replies, and filing them into folders via labels.

Quick Start

Authenticate with Google:

  • python scripts/auth.py login Check authentication status:
  • python scripts/auth.py status Logout when needed:
  • python scripts/auth.py logout

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I automate Gmail workflows like searching and sending emails?โ–ผ

You can automate Gmail workflows by using a Python client that supports search, read, compose, send, and label operations. It enables quick message retrieval using Gmail query syntax and streamlines daily email triage.

How does OAuth authentication work for Gmail API automation?โ–ผ

OAuth authentication for Gmail API automation works via a local browser flow. The client stores tokens securely in the system keyring, allowing you to manage login, status checks, and logout through simple Python scripts.

Can I manage Gmail drafts and labels with Python?โ–ผ

Yes, you can manage Gmail drafts and labels with Python. The client supports draft management and label operations, allowing you to archive messages, mark them as read or unread, and star items to streamline inbox workflows.

Does this Gmail automation client support CC, BCC, and HTML content?โ–ผ

Yes, this Gmail automation client supports reading, composing, and sending emails with support for CC and BCC recipients. It also accommodates HTML content, allowing you to generate formatted replies through the Python client.

Do I need the keyring package to use this Gmail API client?โ–ผ

Yes, you need the keyring package because the client uses it to securely store OAuth tokens obtained during the local browser login flow. This dependency ensures your Gmail API authentication credentials are managed safely.

What is the best way to triage priority Gmail messages automatically?โ–ผ

The best way to triage priority Gmail messages automatically is by combining Gmail query syntax for searching, generating replies, and filing them into folders via label modification through a lightweight Python client.