gmail

Read, search, and send Gmail messages via REST API.

76|18|Updated Dec 12, 2025
One-click install
npx skills add https://github.com/vm0-ai/vm0-skills --skill gmail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/vm0-ai/vm0-skills/tree/main/gmail
Command: npx skills add https://github.com/vm0-ai/vm0-skills --skill gmail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This Skill enables reading, composing, and organizing Gmail data via REST, automating email workflows and labeling.

Core Features & Use Cases

  • Read and search messages, threads, and profiles
  • Send emails and replies, manage drafts
  • Create and modify labels
  • List and manage threads and attachments

Quick Start

Quick start: fetch profile and list messages with Gmail API using a refreshed 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 emails using the Gmail API?

Gmail API enables programmatic access to read, search, and retrieve messages and threads via REST endpoints. Use OAuth 2.0 credentials and refresh tokens with curl to authenticate, then craft HTTP requests with proper headers to query your mailbox, filter by labels, and extract message content.

Can I send emails and manage drafts through Gmail API?

Yes, Gmail API supports composing, sending, and managing draft messages programmatically. Use curl to POST formatted messages to Gmail REST endpoints with your OAuth 2.0 access token, enabling automation of email composition and delivery within workflows.

How do I organize emails with labels and threads via the Gmail API?

Gmail API lets you create, modify, and apply labels to organize messages and threads programmatically. Use curl-based HTTP requests with jq to parse responses and manage label hierarchies, enabling automated email organization and categorization in bulk workflows.

What OAuth 2.0 setup do I need before using Gmail API automation?

Gmail API requires OAuth 2.0 credentials and refresh tokens for secure authentication. You must set up OAuth consent, generate credentials from Google Cloud Console, obtain refresh tokens through the authorization flow, and include them in curl request headers to access Gmail endpoints.

Can I access Gmail attachments and retrieve message metadata programmatically?

Gmail API enables retrieval of attachment metadata and full message details including headers, body, and thread information. Use curl with proper authorization to fetch message objects, then parse responses with jq to extract attachment IDs, sizes, and content metadata for processing.