gmcli — скилл для Claude Code: управление Gmail из терминала
Скилл gmcli добавляет агенту доступ к Gmail через командную строку. Ищите письма, читайте треды, отправляйте сообщения и работайте с черновиками и ярлыками прямо из кода.
MIT 160 установок ★ 2 663 обновлён 2026-06-06
npx skills add badlogic/pi-skills --skill gmcli -a claude-codeЧто делает gmcli
gmcli — это интерфейс командной строки для операций с Gmail. Агент может искать письма по запросу, открывать полные треды, отправлять письма с заданной темой и телом, управлять черновиками, просматривать и применять ярлыки, скачивать вложения. Все команды работают через стандартный синтаксис поиска Gmail.
Для работы нужна одноразовая настройка в Google Cloud Console: создать проект, включить Gmail API, настроить OAuth-приложение для десктопа и загрузить файл учётных данных. Затем скилл добавляет аккаунт командой gmcli accounts credentials и сохраняет токены локально в ~/.gmcli/. Вложения скачиваются в ~/.gmcli/attachments/.
Устанавливается один раз для выбранной платформы. После этого агент получает полный доступ к операциям с почтой — от поиска до управления черновиками.
Какие задачи решает
- искать письма по теме, отправителю или дате
- прочитать весь тред целиком с историей сообщений
- отправить письмо с темой и текстом
- работать с черновиками и ярлыками
- скачать и обработать вложения
Примеры запросов агенту
- Найди мне письма от менеджера про встречу на этой неделе
- Прочитай весь тред с письма номер 17abc4d9e5f6g7h8
- Отправь письмо на почту [email protected] с темой «Отчёт готов» и сообщением о том, что я загрузил файл
Как установить gmcli
1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gmcli -a claude-code2Вручную: положить файлы
~/.claude/skills/gmcli/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gmcli/
1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gmcli -a codex2Вручную: положить файлы
.agents/skills/gmcli/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gmcli -a cursor2Вручную: положить файлы
.cursor/skills/gmcli/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install badlogic/pi-skills gmcli2Вручную: положить файлы
.github/skills/gmcli/SKILL.md1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gmcli -a gemini-cli2Командой платформы
gemini skills install https://github.com/badlogic/pi-skills --path gmcliВручную: положить файлы
.devin/skills/gmcli/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gmcli -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gmcli
Как установить gmcli в Claude Code?
Выполни команду npx skills add badlogic/pi-skills --skill gmcli -a claude-code. После этого скилл будет доступен по пути ~/.claude/skills/gmcli/SKILL.md.
Что нужно сделать перед первым использованием?
Создать проект в Google Cloud Console, включить Gmail API, добавить тестовые аккаунты, создать OAuth-приложение для десктопа и скачать JSON-файл учётных данных. Затем запустить gmcli accounts credentials ~/path/to/credentials.json и gmcli accounts add <email>.
Где хранятся учётные данные и скачанные письма?
OAuth-учётные данные и токены аккаунтов находятся в ~/.gmcli/, вложения скачиваются в ~/.gmcli/attachments/.
Исходный текст
SKILL.md · MIT
--- name: gmcli description: Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments. --- # Gmail CLI Command-line interface for Gmail operations. ## Installation ```bash npm install -g @mariozechner/gmcli ``` ## Setup ### Google Cloud Console (one-time) 1. [Create a new project](https://console.cloud.google.com/projectcreate) (or select existing) 2. [Enable the Gmail API](https://console.cloud.google.com/apis/api/gmail.googleapis.com) 3. [Set app name](https://console.cloud.google.com/auth/branding) in OAuth branding 4. [Add test users](https://console.cloud.google.com/auth/audience) (all Gmail addresses you want to use) 5. [Create OAuth client](https://console.cloud.google.com/auth/clients): - Click "Create Client" - Application type: "Desktop app" - Download the JSON file ### Configure gmcli First check if already configured: ```bash gmcli accounts list ``` If no accounts, guide the user through setup: 1. Ask if they have a Google Cloud project with Gmail API enabled 2. If not, walk them through the Google Cloud Console steps above 3. Have them download the OAuth credentials JSON 4. Run: `gmcli accounts credentials ~/path/to/credentials.json` 5. Run: `gmcli accounts add <email>` (use `--manual` for browserless OAuth) ## Usage Run `gmcli --help` for full command reference. Common operations: - `gmcli <email> search "<query>"` - Search emails using Gmail query syntax - `gmcli <email> thread <threadId>` - Read a thread with all messages - `gmcli <email> send --to <emails> --subject <s> --body <b>` - Send email - `gmcli <email> labels list` - List all labels - `gmcli <email> drafts list` - List drafts ## Data Storage - `~/.gmcli/credentials.json` - OAuth client credentials - `~/.gmcli/accounts.json` - Account tokens - `~/.gmcli/attachments/` - Downloaded attachments
© badlogic · MIT · badlogic/pi-skills