skills.rest
xuiltul
xuiltulCOMMUNITY
Explore all skills by this author →
GitHub

gmail-tool

Reads and manages Gmail messages via OAuth2 API, including listing unread emails, reading bodies, and creating drafts.

253|42|Updated Feb 18, 2026
Search Tags:#automation#email#inbox#gmail#draft#oauth2#unread
One-click install
npx skills add https://github.com/xuiltul/animaworks --skill gmail-tool
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail-tool
Source: https://github.com/xuiltul/animaworks/tree/main/templates/ja/common_skills/gmail-tool
Command: npx skills add https://github.com/xuiltul/animaworks --skill gmail-tool

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides programmatic, authenticated access to a Gmail account so agents can monitor unread mail, read full message content, and prepare draft messages without manual mailbox interaction.

Core Features & Use Cases

  • List unread messages: Retrieve unread emails with a configurable maximum result count for inbox monitoring.
  • Read message body: Fetch and surface full message content by message ID for summarization or task routing.
  • Create drafts: Compose drafts (optionally attached to an existing thread) to prepare replies or templated messages.
  • Use Case: Automatically monitor a support inbox, summarize new unread messages, and create draft replies for a human reviewer.

Quick Start

Ask the gmail-tool to list unread messages and then read the body of the most recent message, completing the OAuth2 authentication flow when prompted.

Frequently Asked Questions about gmail-tool

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

FAQPage Schema
How do I list unread Gmail messages programmatically?▼

To list unread Gmail messages programmatically, this Skill retrieves them via the Gmail API using OAuth2 authentication. It fetches unread emails with a configurable maximum result count for automated inbox monitoring workflows.

Can I create Gmail drafts automatically from an agent workflow?▼

Yes, you can create Gmail drafts automatically. This Skill composes draft messages via the Gmail API, optionally attaching them to existing threads, preparing templated replies or support responses for human review within automated agent workflows.

Do I need OAuth2 credentials to read Gmail message bodies?▼

Yes, OAuth2 credentials are required to read Gmail message bodies. This Skill expects credentials.json and token.json files available in the ~/.animaworks/ directory to execute authenticated Gmail API calls and fetch full message content by message ID.

What is the best way to monitor a support inbox and summarize unread emails?▼

The best way to monitor a support inbox and summarize unread emails is using this Skill to list unread messages and read their full bodies. It programmatically surfaces message content for task routing and automated summarization workflows.

How does OAuth2 authentication work for Gmail API automation workflows?▼

OAuth2 authentication for Gmail API automation works by placing credentials.json and token.json in the ~/.animaworks/ directory. The Skill uses these files to authenticate API calls, enabling programmatic access to list unread emails, read bodies, and create drafts.

Related Skills

Explore More Content & Communication Skills→
steipetesteipete
385.7k

bird

Read, search, and post on X/Twitter via CLI with cookie or API authentication.

Community
Intermediate
abdullahsheikh01abdullahsheikh01

whatsapp-processing

Process WhatsApp message action files to draft replies and create approval requests.

Community
Intermediate
ABLER-Digital-ServicesABLER-Digital-Services

req-fn-app-notification-list

Create a reviewable inventory of system notifications with recipients, triggers, and content.

Official
Intermediate
marcosmlsliramarcosmlslira

agent-email-inbox

Configure and monitor a Resend-based inbound email inbox with webhook verification.

Community
Advanced