Back to Skills

gmail

This skill should be used when searching, fetching, or downloading emails from Gmail. Use for queries like "search Gmail for...", "find emails from John", "show unread emails", "emails about project X", or "download attachment from email".

17stars1forksUpdated 2/21/2026

Security Assessment

Safe(100/100)
Security Score100/100

About gmail

The Gmail skill allows users to search, fetch, and download emails from Gmail using the Gmail API. It solves the problem of manually navigating Gmail's interface by providing a simple command-line interface for searching and managing emails. This skill is designed for users who need automated access to Gmail data, such as retrieving specific emails or downloading attachments based on custom filters or queries.

FAQ

How do I set up the Gmail skill?

To set up the Gmail skill, you must configure your Gmail API credentials, which can be done by following the steps in the documentation to create a Google Cloud Project, enable the Gmail API, and configure OAuth credentials.

What permissions do I need for this skill to work?

You need to authenticate using OAuth and grant the skill appropriate access. The default scope is 'readonly', but you can set it to 'modify' or 'full' depending on the level of access you need.

Can I use this skill with non-Gmail accounts?

No, this skill is specifically designed to interact with Gmail via the Gmail API. It will not work with other email providers.

What are the limitations of the Gmail skill?

The skill's functionality is limited by the Gmail API's capabilities and permissions. It can only interact with Gmail accounts, and users must authenticate periodically as tokens expire after 7 days.

All Files

2 files
README.md4.3 KB
View
SKILL.md8.2 KB
View

Install gmail

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill