gmail

Send, search, and organize Gmail emails, drafts, and labels via the Gmail API.

12|5|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/odyssey4me/agent-skills --skill gmail-odyssey4me
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/odyssey4me/agent-skills/tree/main/skills/gmail
Command: npx skills add https://github.com/odyssey4me/agent-skills --skill gmail-odyssey4me

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-auth, google-auth-oauthlib, google-api-python-client, keyring, pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines email management by allowing you to send, search, and organize your Gmail messages, drafts, and labels directly through AI commands.

Core Features & Use Cases

  • Email Composition & Sending: Compose and send new emails, including CC and BCC recipients.
  • Search & Retrieval: Find specific emails using powerful search queries, including by sender, subject, or labels.
  • Draft Management: Create, list, and send draft emails.
  • Label Organization: List and create new labels to categorize your messages.
  • Use Case: Quickly reply to an urgent email, search your inbox for a specific document, or create a draft for a follow-up message without leaving your AI assistant.

Quick Start

Use the gmail skill to list all unread messages in your inbox.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I search Gmail inbox for specific emails programmatically?

You can search Gmail inbox programmatically using advanced search queries by sender, subject, or labels via the Gmail API to retrieve specific messages directly through AI commands.

Can I compose and send emails with CC and BCC recipients through an AI assistant?

Yes, you can compose and send emails with CC and BCC recipients through an AI assistant by using the Gmail API to programmatically generate and dispatch messages without leaving your workflow.

Do I need OAuth 2.0 authentication to manage Gmail drafts and labels via API?

Yes, OAuth 2.0 authentication is required to manage Gmail drafts and labels via the API, along with specific Google API client libraries for Python including google-auth and google-api-python-client.

What's the best way to organize Gmail messages using custom labels?

The best way to organize Gmail messages is by using the Gmail API to list existing labels and create new ones, allowing you to categorize messages programmatically through AI commands.

Can I create and send draft emails in Gmail without opening a browser?

Yes, you can create, list, and send draft emails in Gmail without opening a browser by using the Gmail API to programmatically manage drafts through AI commands.

Why does Gmail API access require specific Python client libraries?

Gmail API access requires specific Python client libraries like google-auth, google-auth-oauthlib, and google-api-python-client to handle OAuth 2.0 authentication and construct valid API requests for sending, searching, and organizing emails.