mail

Automate Gmail inbox management and attachment downloads via mail-cli.

5|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/vincentor/claude-code-plugins --skill mail-vincentor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mail
Source: https://github.com/vincentor/claude-code-plugins/tree/main/mail-cli/skills/mail
Command: npx skills add https://github.com/vincentor/claude-code-plugins --skill mail-vincentor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables users to manage Gmail directly from Claude, allowing you to list messages, read content, search across conversations, and download attachments without leaving the chat.

Core Features & Use Cases

  • List recent emails and unread messages to stay on top of your inbox
  • Read email content and download attachments on demand
  • Search emails by subject, sender, or labels to quickly locate important messages

Quick Start

Use the mail-cli tool to authenticate and perform common tasks:

  • List emails: uv run mail-cli list
  • Read an email: uv run mail-cli read <message_id>
  • Search emails: uv run mail-cli search -q "subject:..."
  • Download attachments: uv run mail-cli attachments <message_id> --all

Frequently Asked Questions about mail

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

FAQPage Schema
How do I search and read Gmail emails directly from the command line?

You can search and read Gmail emails from the command line using the mail-cli utility, which supports listing messages, reading content, and querying by subject, sender, or labels. It requires Gmail OAuth credentials for authentication.

Can I download Gmail attachments via CLI without opening a browser?

Yes, you can download Gmail attachments via CLI without a browser by executing the mail-cli attachments command with a specific message ID. This skill automates attachment retrieval directly within your terminal environment.

Do I need to set up Gmail OAuth credentials to manage my inbox from the CLI?

Yes, setting up Gmail OAuth credentials is required to manage your inbox from the CLI. The mail-cli utility relies on this authentication to securely access your account, list unread messages, and retrieve email content.

What is the best way to list unread Gmail messages in a terminal environment?

The best way to list unread Gmail messages in a terminal is by running the mail-cli list command. This skill enables direct inbox management, allowing you to monitor recent emails and filter unread conversations effortlessly.

How does searching Gmail by subject or sender work with mail-cli?

Searching Gmail by subject or sender with mail-cli works by passing query parameters to the search command, such as using the -q flag followed by specific criteria like "subject:...". This allows precise message retrieval across conversations.

Are there limitations to managing Gmail conversations through a CLI tool?

Limitations of managing Gmail through a CLI tool include dependency on the mail-cli utility and valid OAuth credentials. Without these configured, the skill cannot perform inbox management, message retrieval, or attachment downloads.