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

gmcli — скилл для Claude Code: управление Gmail из терминала

Скилл gmcli добавляет агенту доступ к Gmail через командную строку. Ищите письма, читайте треды, отправляйте сообщения и работайте с черновиками и ярлыками прямо из кода.

MIT 160 установок ★ 2 663 обновлён 2026-06-06

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

Что делает 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-code

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

~/.claude/skills/gmcli/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Заметки, задачи и проекты» →
recipe-label-and-archive-emails официальный googleworkspace Скилл recipe-label-and-archive-emails для Claude Code организует почту: ищет письма в Gmail по условию, добавляет метки и архивирует их через Google Workspace CLI. CX Codex +1 31 500установок gws-gmail-send официальный googleworkspace Даёт агенту команду gws gmail +send. Отправляет письма через Gmail с вложениями, CC/BCC, HTML-телом и алиасами отправителя. CX Codex +1 76 800установок gmail glebis Поиск писем в Gmail через API с фильтрами по отправителю, дате, статусу и вложениям. CX Codex +1 258установок gws-gmail-triage davila7 Команда gws-gmail-triage показывает сводку непрочитанных писем Gmail с отправителем, темой и датой через утилиту Google Workspace CLI. CX Codex +1 78установок gmail-access terrylica Скилл gmail-access для Claude Code подключает Gmail через CLI: читает и ищет письма, выгружает результаты и создаёт черновики. Даёт доступ к переписке в ходе работы над проектом. CX Codex +1 137установок inbox-triage Alireza Rezvani Скилл inbox-triage для Claude Code разбирает новые письма по вашей классификации, изучает неизвестных отправителей и готовит черновики ответов. Запускается по просьбе обработать почту или по расписанию. CX Codex +1 408установок

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

brave-search Ищет информацию в вебе и извлекает текст страниц в Markdown через официальный Brave Search API без запуска браузера. CX Codex +1 1 400установок youtube-transcript Скилл youtube-transcript для Claude Code загружает текстовую дорожку YouTube-видео и отдаёт её агенту с метками времени. Принимает ID или URL — доступны автоматические и ручные субтитры. CX Codex +1 930установок transcribe Скилл transcribe для Claude Code расшифровывает речь локально на Apple Silicon macOS. WAV обрабатывает напрямую, остальные форматы — через ffmpeg. CX Codex +1 851установок browser-tools Скилл browser-tools подключает агент к Chrome через Chrome DevTools Protocol для навигации, проверки интерфейсов и работы с динамическими страницами. CX Codex +1 479установок gccli Скилл gccli для Claude Code обучает ИИ-агента управлять Google Calendar через консольную утилиту. Агент просматривает календари, создаёт и меняет события, проверяет свободные окна. CX Codex +1 177установок gdcli Скилл добавляет CLI для Google Drive прямо в редактор: список файлов, поиск по содержимому, загрузка и скачивание, создание папок, общий доступ. Запускается командами вроде gdcli <email> ls или gdcli <email> search. CX Codex +1 169установок vscode Скилл учит ИИ-агента открывать наглядные диффы и сравнивать версии файлов в VS Code через встроенный CLI. CX Codex +1 155установок

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

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

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