# gmail-skill

Читает, ищет и отправляет письма Gmail, работает с контактами Google. Пригодится, когда агент должен разобрать входящие или подготовить черновик.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3600 установок · ★ 14
- Автор: idanbeck
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/idanbeck/claude-skills/tree/HEAD/gmail-skill/SKILL.md
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/skills/gmail-skill

## Что делает

Скилл даёт агенту доступ к Gmail через скрипт `gmail_skill.py`. Поиск идёт по обычным запросам Gmail: `from:`, `subject:`, `has:attachment`, `is:unread`. Есть чтение письма по ID, список последних, метки, звёздочки, архивация и возврат из архива. Контакты Google тоже под рукой — список и поиск по имени, почте или телефону.

Перед первой отправкой придётся один раз настроить OAuth-клиент в Google Cloud Console: включить Gmail API и People API, добавить себя тестовым пользователем, скачать JSON и положить его в `~/.claude/skills/gmail-skill/credentials.json`. Дальше браузер откроется сам. Поддерживается несколько аккаунтов, нужный выбирается флагом `--account`.

Отправка устроена осторожно: скилл сначала показывает письмо целиком — от кого, кому, тему и текст — и ждёт явного подтверждения. Без «да» или «отправляй» команда не выполнится, даже если вы сразу попросили отправить. Если раньше стоял gmail-reader, авторизацию придётся пройти заново: нужен новый scope `gmail.send`.

## Требования
- Работает с: Gmail

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add idanbeck/claude-skills --skill gmail-skill -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/gmail-skill/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/gmail-skill/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add idanbeck/claude-skills --skill gmail-skill -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/gmail-skill/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add idanbeck/claude-skills --skill gmail-skill -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/gmail-skill/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install idanbeck/claude-skills gmail-skill
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/gmail-skill/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add idanbeck/claude-skills --skill gmail-skill -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/idanbeck/claude-skills --path gmail-skill
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/gmail-skill/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add idanbeck/claude-skills --skill gmail-skill -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/idanbeck/claude-skills/tree/HEAD/gmail-skill/SKILL.md

## Когда брать
- найти письма от конкретного отправителя за период
- создать черновик ответа в нужной ветке переписки
- посмотреть, что пришло на рабочий ящик, не открывая браузер
- узнать почту или телефон человека из контактов
- отправить письмо с вложением из командной строки

## Примеры запросов агенту
- найди непрочитанные письма с вложениями PDF за последнюю неделю
- создай черновик ответа на письмо 19b99b3127793843 с аккаунта work@company.com
- покажи контакты, у кого в имени есть Иван

## Похожие
- [gws-gmail](https://affpapa.org/nevibecode/skills/gws-gmail.md) — скилл · 82100 установок
- [gws-gmail-send](https://affpapa.org/nevibecode/skills/gws-gmail-send.md) — скилл · 74800 установок
- [google](https://affpapa.org/nevibecode/skills/vercel-labs-google.md) — скилл · 364 установки
- [gmail-workflows](https://affpapa.org/nevibecode/skills/gmail-workflows.md) — скилл · 5000 установок
- [inbox-triage](https://affpapa.org/nevibecode/skills/inbox-triage.md) — скилл · 408 установок
- [Inbox Zero](https://affpapa.org/nevibecode/mcp/inbox-zero.md) — MCP-сервер · ★ 12791

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md