gmail-skill — скилл для Claude Code: почта Gmail и контакты
Читает, ищет и отправляет письма Gmail, работает с контактами Google. Пригодится, когда агент должен разобрать входящие или подготовить черновик.
npx skills add idanbeck/claude-skills --skill gmail-skill -a claude-codeЧто делает 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.
Какие задачи решает
- найти письма от конкретного отправителя за период
- создать черновик ответа в нужной ветке переписки
- посмотреть, что пришло на рабочий ящик, не открывая браузер
- узнать почту или телефон человека из контактов
- отправить письмо с вложением из командной строки
Примеры запросов агенту
- найди непрочитанные письма с вложениями PDF за последнюю неделю
- создай черновик ответа на письмо 19b99b3127793843 с аккаунта [email protected]
- покажи контакты, у кого в имени есть Иван
Как установить gmail-skill
1Через Skills CLI (Vercel)
npx skills add idanbeck/claude-skills --skill gmail-skill -a claude-code2Вручную: положить файлы
~/.claude/skills/gmail-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gmail-skill/
1Через Skills CLI (Vercel)
npx skills add idanbeck/claude-skills --skill gmail-skill -a codex2Вручную: положить файлы
.agents/skills/gmail-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add idanbeck/claude-skills --skill gmail-skill -a cursor2Вручную: положить файлы
.cursor/skills/gmail-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install idanbeck/claude-skills gmail-skill2Вручную: положить файлы
.github/skills/gmail-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add idanbeck/claude-skills --skill gmail-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/idanbeck/claude-skills --path gmail-skillВручную: положить файлы
.devin/skills/gmail-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add idanbeck/claude-skills --skill gmail-skill -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gmail-skill
Как установить gmail-skill в Claude?
Выполните npx skills add idanbeck/claude-skills --skill gmail-skill -a claude-code. Скилл встанет в ~/.claude/skills/gmail-skill/SKILL.md.
Что делает gmail-skill?
Ищет и читает письма Gmail, отправляет их, создаёт черновики, ставит метки и звёздочки, архивирует. Отдельно умеет искать по контактам Google.
Нужно ли подтверждать отправку письма?
Да. Скилл показывает полный текст письма и ждёт явного согласия, и только потом запускает отправку. Это правило действует и в режиме пропуска разрешений.
