К основному содержанию
скилл CX Codex

gmail · glebis — скилл для Claude Code и ещё пяти платформ

Скилл для Claude Code: поиск писем в Gmail через API с фильтрами по отправителю, дате, статусу и вложениям.

MIT 258 установок ★ 414 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add glebis/claude-skills --skill gmail -a claude-code
Открыть на GitHub

Что делает gmail

Подключается через OAuth-аутентификацию в Google Cloud. Перед первым запуском нужно создать проект в console.cloud.google.com, включить Gmail API, настроить OAuth Consent Screen и добавить свой Gmail как тестовый пользователь. Затем сохраняют credentials в ~/.gmail_credentials/credentials.json и запускают python3 scripts/gmail_search.py auth.

Поиск работает с Gmail-синтаксисом запросов: свободный текст вроде «meeting notes», флаги вроде --from, --subject, --unread, фильтры по датам (--after 2024/01/01). Результаты выводят в Markdown или JSON. Команда download MESSAGE_ID загружает вложения в ~/Downloads/gmail_attachments/ или в указанную папку.

Токены тестовых пользователей действуют семь дней. На production нужна верификация Google.

Какие задачи решает

  • найти письма по отправителю, теме или дате
  • загрузить вложение из письма на диск
  • выбрать непрочитанные или помеченные письма
  • поискать по тексту письма с Gmail-синтаксисом
  • вывести список писем в JSON для обработки

Примеры запросов агенту

  • Поищи в Gmail письма от [email protected] за последний месяц
  • Загрузи вложение из письма 18abc123def
  • Найди все непрочитанные письма с темой invoice и скачай вложения

Как установить gmail

1Через Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill gmail -a claude-code

2Вручную: положить файлы

~/.claude/skills/gmail/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/gmail/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о gmail

Как установить gmail для Claude Code?

Запусти npx skills add glebis/claude-skills --skill gmail -a claude-code. Затем отредактируй ~/.claude/skills/gmail/SKILL.md.

Что делает скилл gmail?

Ищет письма в Gmail по ключевым словам, отправителю, дате, статусу и вложениям. Может загружать вложения на диск и выводить результаты в Markdown или JSON.

Как получить credentials для Gmail?

Создай проект в Google Cloud Console, включи Gmail API, настрой OAuth Consent Screen с тестовым пользователем, опубликуй приложение, создай OAuth client ID типа Desktop, сохрани JSON в ~/.gmail_credentials/credentials.json, затем запусти python3 scripts/gmail_search.py auth.

Исходный текст

SKILL.md · MIT
---
name: gmail
description: 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".
---

# 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:

```bash
python3 scripts/gmail_search.py setup
```

### Obtaining Gmail API Credentials

#### 1. Create Google Cloud Project

1. Go to [console.cloud.google.com](https://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".

1. Go back to "OAuth consent screen"
2. Under "Publishing status", click "Publish App"
3. Confirm the dialog

This keeps the app in test mode (not production) but allows your test users to authenticate. You'll see an "unverified app" warning during login - click "Advanced" -> "Go to Gmail Agent Skill (unsafe)" to proceed.

**Note:** Test tokens expire after 7 days. Production requires Google verification.

#### 5. Create OAuth Credentials

1. Go to "Credentials" (left sidebar)
2. Click "Create Credentials" -> "OAuth client ID"
3. Select "Desktop app" as application type
4. Name it (e.g., "Gmail Agent Client")
5. Click "Create"

#### 6. Get Your Credentials

1. Client ID will be displayed - copy it
2. Client Secret: Click the download icon or view details to get the secret

#### 7. Save Credentials

Create `~/.gmail_credentials/credentials.json`:

```json
{
  "installed": {
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "redirect_uris": ["http://localhost"]
  }
}
```

#### 8. Authenticate

```bash
python3 scripts/gmail_search.py auth
```

This opens a browser. Click through the "unverified app" warning ("Advanced" -> "Go to Gmail Agent Skill"), approve access, and you're ready.

## Quick Start

```bash
# Check setup status
python3 scripts/gmail_search.py setup

# Authenticate (opens browser)
python3 scripts/gmail_search.py auth

# Search emails
python3 scripts/gmail_search.py search "meeting notes"

# Search with filters
python3 scripts/gmail_search.py search --from "[email protected]" --unread
```

## Commands

### Setup

Check configuration status:

```bash
python3 scripts/gmail_search.py setup
python3 scripts/gmail_search.py setup --json
```

### Authenticate

Authenticate with Gmail (opens browser for OAuth):

```bash
python3 scripts/gmail_search.py auth
```

### Scope

View or change API permission scope:

```bash
# View current scope
python3 scripts/gmail_search.py scope

# Change scope (requires re-auth)
python3 scripts/gmail_search.py scope --set readonly
python3 scripts/gmail_search.py scope --set modify
python3 scripts/gmail_search.py scope --set full
```

**Available scopes:**
- `readonly` - Read emails only (default, recommended)
- `modify` - Read + modify labels, mark read/unread
- `full` - Full access including delete

### Search

Search emails with free-text query or filters:

```bash
# Free-text search (uses Gmail search syntax)
python3 scripts/gmail_search.py search "project deadline"
python3 scripts/gmail_search.py search "from:[email protected] subject:invoice"

# Using helper flags
python3 scripts/gmail_search.py search --from "[email protected]"
python3 scripts/gmail_search.py search --to "[email protected]"
python3 scripts/gmail_search.py search --subject "Weekly Report"
python3 scripts/gmail_search.py search --label "INBOX"
python3 scripts/gmail_search.py search --label "work"

# Date filters (YYYY/MM/DD format)
python3 scripts/gmail_search.py search --after 2024/01/01
python3 scripts/gmail_search.py search --before 2024/12/31
python3 scripts/gmail_search.py search --after 2024/01/01 --before 2024/06/30

# Status filters
python3 scripts/gmail_search.py search --unread
python3 scripts/gmail_search.py search --starred
python3 scripts/gmail_search.py search --has-attachment

# Combined filters
python3 scripts/gmail_search.py search "invoice" --from "billing@" --has-attachment --after 2024/01/01

# Limit results
python3 scripts/gmail_search.py search "meeting" --limit 50

# Include full body (default shows snippet only)
python3 scripts/gmail_search.py search "contract" --full

# Include attachment info
python3 scripts/gmail_search.py search --has-attachment --attachments

# JSON output
python3 scripts/gmail_search.py search "project" --json
```

### Download Attachments

Download attachments from a specific message:

```bash
# Download to default location (~/Downloads/gmail_attachments/)
python3 scripts/gmail_search.py download MESSAGE_ID

# Download to custom directory
python3 scripts/gmail_search.py download MESSAGE_ID --output /path/to/folder

# JSON output
python3 scripts/gmail_search.py download MESSAGE_ID --json
```

Get message ID from search results (shown in output).

### Labels

List all available Gmail labels:

```bash
python3 scripts/gmail_search.py labels
python3 scripts/gmail_search.py labels --json
```

## Output Formats

### Markdown (default)

```markdown
# Gmail Search Results (3 messages)

## Weekly Report
**From:** [email protected]
**To:** [email protected]
**Date:** Mon, 25 Nov 2024 10:00:00 +0000
**ID:** `18abc123def`

> Here's the weekly report summary...

---
```

### JSON

Add `--json` flag for structured output:

```json
[
  {
    "id": "18abc123def",
    "thread_id": "18abc123def",
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Weekly Report",
    "date": "Mon, 25 Nov 2024 10:00:00 +0000",
    "snippet": "Here's the weekly report summary...",
    "labels": ["INBOX", "UNREAD"]
  }
]
```

## Gmail Search Syntax

The skill supports Gmail's native search syntax in free-text queries:

| Operator | Example | Description |
|----------|---------|-------------|
| `from:` | `from:[email protected]` | From specific sender |
| `to:` | `to:[email protected]` | To specific recipient |
| `subject:` | `subject:meeting` | In subject line |
| `label:` | `label:work` | Has specific label |
| `has:attachment` | `has:attachment` | Has attachments |
| `filename:` | `filename:pdf` | Attachment filename |
| `is:unread` | `is:unread` | Unread messages |
| `is:starred` | `is:starred` | Starred messages |
| `after:` | `after:2024/01/01` | After date |
| `before:` | `before:2024/12/31` | Before date |
| `newer_than:` | `newer_than:7d` | Within last N days |
| `older_than:` | `older_than:1m` | Older than N months |
| `in:` | `in:inbox` | In specific folder |
| `OR` | `from:john OR from:jane` | Either condition |
| `-` | `-label:spam` | Exclude |
| `""` | `"exact phrase"` | Exact match |

## Example User Requests

| User says | Command |
|-----------|---------|
| "Search Gmail for meeting notes" | `search "meeting notes"` |
| "Find emails from John" | `search --from "john"` |
| "Show unread emails" | `search --unread` |
| "Emails about the project from last month" | `search "project" --after 2024/10/01` |
| "Invoices with attachments" | `search "invoice" --has-attachment` |
| "Read the full email about contract" | `search "contract" --full --limit 1` |
| "Download attachments from that email" | `download MESSAGE_ID` |
| "What labels do I have?" | `labels` |
| "Starred emails from boss" | `search --from "boss" --starred` |
| "Is Gmail configured?" | `setup` |

## Dependencies

```bash
pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib
```

## Files

- `~/.gmail_credentials/credentials.json` - OAuth client credentials
- `~/.gmail_credentials/token.pickle` - Cached auth token
- `~/.gmail_credentials/scope.txt` - Current scope setting

© glebis · MIT · glebis/claude-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — gmail от других авторов.

gmail sanjay3290 Ищет, читает и отправляет письма через Gmail из чата с агентом. Разбирает входящие, управляет ярлыками и создаёт черновики. CX Codex +1 528установок gmail membrane Скилл подключает агента к Gmail через Membrane: он ищет письма, работает с черновиками, ярлыками и цепочками. Подходит для почтовых сценариев из командной строки. CX Codex +1 782установок gws-gmail-send официальный googleworkspace Даёт агенту команду gws gmail +send. Отправляет письма через Gmail с вложениями, CC/BCC, HTML-телом и алиасами отправителя. CX Codex +1 76 800установок recipe-create-gmail-filter официальный googleworkspace Скилл recipe-create-gmail-filter для Claude Code создаёт фильтры Gmail, которые автоматически ставят метки и звёздочки или перемещают письма в папки. CX Codex +1 32 400установок gmail-skill idanbeck Читает, ищет и отправляет письма Gmail, работает с контактами Google. Разбирает входящие и готовит черновики. CX Codex +1 3 600установок gmail-access terrylica Скилл gmail-access для Claude Code подключает Gmail через CLI: читает и ищет письма, выгружает результаты и создаёт черновики. Даёт доступ к переписке в ходе работы над проектом. CX Codex +1 137установок Multi-Account Gmail cunicopia-dev MCP-сервер Multi-Account Gmail, который держит авторизованными сразу несколько ящиков Gmail и даёт агенту читать, искать, помечать и готовить черновики во всех сразу. CX Codex +1 ★ 6звёзд репо gmail-mcp mkpoli Подключает почту Gmail к ассистенту через собственный Cloudflare Worker. Позволяет читать ящики, слать письма и отвечать во всех цепочках сразу с нескольких аккаунтов. CX Codex +1 ★ 9звёзд репо

Из того же набора51

Весь набор →
brand-agency Скилл brand-agency переносит фирменный стиль Agency в слайды, SVG, HTML и картинки для соцсетей: палитра, шрифты, жёсткие тени и правила вёрстки. CX Codex +1 276установок doctorg Скилл doctorg отвечает на вопросы о здоровье, питании, тренировках и сне, проверяя данные по PubMed, Cochrane, Mayo Clinic и другим проверенным базам. Ставит оценку силы доказательств каждому утверждению. CX Codex +1 265установок tdd Скилл tdd организует разработку через тесты с разделением ролей между отдельными субагентами. Помогает писать код по циклу RED-GREEN-REFACTOR. CX Codex +1 262установок youtube-transcript Скилл youtube-transcript извлекает субтитры и метаданные видео с YouTube, сохраняет в Markdown с YAML-заголовком в хранилище Obsidian. CX Codex +1 258установок transcript-analyzer Скилл transcript-analyzer разбирает расшифровки созвонов через Cerebras AI, вытаскивая решения, задачи, мнения, открытые вопросы и глоссарий терминов. CX Codex +1 258установок zoom Скилл для управления встречами Zoom и облачными записями через API. Создавайте, обновляйте и удаляйте встречи, ищите записи с расшифровками и ссылками на загрузку. CX Codex +1 252установок fathom Загружает из Fathom API встречи, транскрипты, саммари и action items. Автоматизирует работу с записями совещаний в процессе кодинга. CX Codex +1 249установок github-gist Публикует файлы и заметки в GitHub Gist. Создаёт ссылку на снипет или размещает Markdown. CX Codex +1 246установок

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой