manage-gmail

Read, search, and manage Gmail messages and threads via secure OAuth flow.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/weirdapps/integrations-marketplace --skill manage-gmail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manage-gmail
Source: https://github.com/weirdapps/integrations-marketplace/tree/main/plugins/manage-gmail/skills/manage-gmail
Command: npx skills add https://github.com/weirdapps/integrations-marketplace --skill manage-gmail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @google-cloud/local-auth, commander, googleapis, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Reading and managing Gmail via automation is tedious and error-prone when done manually; this skill provides a programmatic interface to access Gmail data and perform common tasks.

Core Features & Use Cases

  • List messages, search, read, read threads
  • Send emails with attachments, reply, forward, and draft
  • Manage user profile and labels for Gmail accounts
  • Use-case: automatically fetch unread messages and summarize them for quick decisions.

Quick Start

Authenticate with Gmail and start listing or reading messages using the CLI.

Frequently Asked Questions about manage-gmail

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

FAQPage Schema
How do I send emails with attachments using Gmail automation?

Gmail automation supports sending emails with optional attachments programmatically. You can send messages, reply, forward, and create drafts by authorizing access through a secure OAuth flow and executing specific operations via the CLI.

What do I need to authenticate Gmail API access for reading and searching messages?

To authenticate Gmail API access, you need the Gmail modify scope, credentials stored at ~/.google-skills/gmail/GMailSkill-Credentials.json, and a generated token saved at ~/.google-skills/gmail/gmail_token.json to enable secure OAuth-powered actions.

Can I manage Gmail labels and user profiles programmatically?

Yes, you can manage Gmail labels and retrieve user profiles programmatically. The interface provides operations for label management and profile retrieval across multiple accounts once the OAuth authentication flow is successfully completed.

How does OAuth work for listing and reading Gmail message threads?

OAuth enables programmatic access to list, search, and read Gmail message threads securely. After storing local credentials and generating an access token, the CLI authenticates your session to execute thread-level reading and searching operations.

What is the best way to automate fetching unread Gmail messages for summarization?

The best way to automate fetching unread Gmail messages for summarization is using this programmatic interface to search and list unread messages. You can then process the extracted email data to generate quick decision summaries.

Are there limitations when using local auth for Gmail modify scope operations?

Using local auth for Gmail modify scope operations requires valid credential files at specified local paths. Operations are limited to reading, sending, drafting, and label management within the authenticated account's permissions.