Lets you search and fetch emails from Gmail using the API, with support for filters like sender, date ranges, unread status, and attachments. Setup requires creating a Google Cloud project and OAuth credentials, which the docs walk through step by step. The skill defaults to readonly scope, which is smart. Outputs markdown or JSON, and you can download attachments directly. One thing to know: test tokens expire after 7 days unless you go through Google's full verification process, so you'll need to re-authenticate weekly. The Gmail search syntax support is comprehensive, covering everything from basic queries to complex boolean filters.

skills.sh installs
257
GitHub stars
412
last updated
Aug 21, 2026

Install

$ npx -y skills add glebis/claude-skills --skill gmail --agent claude-code

Installs into .claude/skills of the current project.

Files

Gmail Search Skill

Search and fetch emails via Gmail API with flexible query options and output formats.

Prerequisites

Credentials must be configured in ~/.gmail_credentials/. Run setup to check status:

python3 scripts/gmail_search.py setup

Obtaining Gmail API Credentials

1. Create Google Cloud Project
  1. Go to console.cloud.google.com
  2. Click project dropdown -> "New Project"
  3. Name it (e.g., "Gmail Agent Skill") -> Create
2. Enable Gmail API
  1. Navigate to "APIs & Services" -> "Library"
  2. Search for "Gmail API"
  3. Click it and press "Enable"
3. Configure OAuth Consent Screen
  1. Go to "OAuth consent screen" (left sidebar)
  2. Choose "External" user type
  3. Fill in required fields:
    • App name: Gmail Agent Skill
    • User support email: your email
    • Developer email: your email
  4. Click "Save and Continue", skip Scopes
  5. On "Test users" page, add your Gmail address
  6. Complete all steps
4. Publish the Test App

Important: Without this step, you'll get "Error 403: access_denied".

Sponsors

Details

Repository
github.com/glebis/claude-skills
Category
Office & Documents
First seen
Jun 3, 2026

More from glebis/claude-skills

All 22
1guia-matthieu avatarpdf-extractorguia-matthieu/clawfu-skillsExtract text, tables, and images from PDFs. Use when: extracting data from reports; converting PDF tables to CSV; pulling images from presentations; processing 255skills.sh installs
2larksuite avatarfeishu-calendarlarksuite/openclaw-lark飞书日历与日程管理工具集。包含日历管理、日程管理、参会人管理、忙闲查询。254skills.sh installs
3davila7 avatarobsidian-clipper-template-creatordavila7/claude-code-templatesGuide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clippe247skills.sh installs
4julianobarbosa avatarobsidianjulianobarbosa/claude-code-skillsGuide for implementing Obsidian knowledge management - vault operations, plugin development, URI scheme automation, markdown extensions, and Local REST API inte243skills.sh installs
5bitbonsai avatarobsidianbitbonsai/mcp-obsidianobsidian238skills.sh installs
6devxoul avatarvibe-notiondevxoul/vibe-notionInteract with Notion using the unofficial private API - pages, databases, blocks, search, users, comments234skills.sh installs