mcpField
G
gmcli

gmcli

github.com/badlogic生産性2.6k157 回インストール21 週間前に更新
リポジトリ

gmcli について

gmcliは、Gmailを操作するコマンドラインツールです。OAuthアカウントを設定すると、メール検索やスレッドの閲覧、送信、ラベルと下書きの管理ができます。

主な機能

  1. 01Gmailクエリ構文でメール検索
  2. 02スレッド内の全メッセージを閲覧
  3. 03メール送信
  4. 04ラベルと下書きの一覧表示
  5. 05OAuthアカウントの設定

活用シーン

  1. 01メールの検索
  2. 02メールスレッド全体の確認
  3. 03コマンドラインからメールを送信
  4. 04ラベルや下書きの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/badlogic/pi-skills --skill gmcli

インストール後、Claude Code で/gmcliを入力して読み込まれたか確認します。

詳細

Gmail CLI

Gmail の操作を行うためのコマンドラインインターフェースです。

インストール

npm install -g @mariozechner/gmcli

セットアップ

Google Cloud Console（一度のみ）
  1. 新しいプロジェクトを作成する（または既存のプロジェクトを選択する）
  2. Gmail API を有効にする
  3. OAuth のブランディングでアプリ名を設定する
  4. テストユーザーを追加する（使用するすべての Gmail アドレス）
  5. OAuth クライアントを作成する：
    • 「Create Client」をクリックします
    • アプリケーションの種類：「Desktop app」
    • JSON ファイルをダウンロードします
gmcli の設定

まず、すでに設定済みか確認します：

gmcli accounts list

アカウントがない場合は、セットアップの手順を案内します：

  1. Gmail API が有効になった Google Cloud プロジェクトがあるか確認します
  2. ない場合は、上記の Google Cloud Console の手順を案内します
  3. OAuth 認証情報の JSON をダウンロードしてもらいます
  4. gmcli accounts credentials ~/path/to/credentials.json を実行します
  5. gmcli accounts add <email> を実行します（ブラウザーを使わない OAuth では --manual を使用します）

使用方法

コマンドの一覧は gmcli --help を実行して確認してください。

一般的な操作：

  • gmcli <email> search "<query>" - Gmail のクエリ構文を使ってメールを検索します
  • gmcli <email> thread <threadId> - すべてのメッセージを含むスレッドを読み取ります
  • gmcli <email> send --to <emails> --subject <s> --body <b> - メールを送信します
  • gmcli <email> labels list - すべてのラベルを一覧表示します
  • gmcli <email> drafts list - 下書きを一覧表示します

データの保存場所

  • ~/.gmcli/credentials.json - OAuth クライアント認証情報
  • ~/.gmcli/accounts.json - アカウントトークン
  • ~/.gmcli/attachments/ - ダウンロードした添付ファイル

コメント

Markdown 対応