gmail

Automate sending, listing, drafting, and searching emails via Composio with OAuth authentication in Pepper workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail is essential for day-to-day communication, but manually coordinating email tasks across tools slows work. This Skill enables seamless Gmail interactions—sending, reading, drafting, and searching emails—within Pepper-enabled workflows.

Core Features & Use Cases

  • Send Email: Compose and dispatch emails to recipients with subject and body content.
  • List Emails: Retrieve emails from your inbox with optional filters (query, max_results, label_ids).
  • Get Email: Retrieve a specific message by its message_id.
  • Create Draft: Save a draft email for later sending.
  • Search Emails: Use Gmail search syntax to locate messages quickly.
  • Real-world use: When awaiting feedback, draft and send a status update or pull unread messages for review.

Quick Start

Ask the agent to send an email to [email protected] with a subject and body.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I automate sending and managing Gmail emails in my workflow?

Automating Gmail interactions is done by connecting a Gmail account via Composio with OAuth authentication, enabling the agent to send, list, draft, and search emails within Pepper-powered workflows.

Can I use Gmail search syntax to filter and retrieve specific inbox messages?

Gmail search syntax can be used to locate and retrieve specific messages quickly, allowing you to filter emails directly within your automated Pepper workflow without manual inbox searching.

Do I need a Composio integration and OAuth to automate Gmail tasks?

A Composio integration and OAuth authentication are required to connect an active Gmail account, serving as the necessary prerequisites to authorize and execute automated email tasks.

What's the best way to create an email draft for later sending through automation?

Creating an email draft is supported as a core feature, allowing you to save a message with subject and body content for later sending directly through an AI prompt in your workflow.

Does listing emails in my inbox support custom filters like max results and label IDs?

Listing emails supports optional filters including query strings, max results, and label IDs, enabling you to retrieve and manage specific subsets of your inbox data programmatically.

How do I retrieve a specific email message by its ID?

Retrieving a specific email message is handled by providing its unique message ID, which fetches the exact message content and metadata from your connected Gmail account.