mcpField
G
gccli

gccli

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

gccli について

Google Calendarを操作するコマンドラインツールです。OAuth設定後、カレンダーや予定の一覧・詳細確認、予定の作成、空き時間の確認を行えます。

主な機能

  1. 01カレンダーと予定の一覧表示
  2. 02予定の詳細確認
  3. 03カレンダー予定の作成
  4. 04空き時間の確認
  5. 05OAuthアカウントの設定

活用シーン

  1. 01複数のカレンダーの予定確認
  2. 02カレンダー予定の作成
  3. 03指定期間の空き状況確認

インストール

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

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

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

詳細

Google Calendar CLI

Google Calendar を操作するためのコマンドラインインターフェースです。

インストール

npm install -g @mariozechner/gccli

セットアップ

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

まず、設定済みかどうかを確認します：

gccli accounts list

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

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

使用方法

コマンドの全リファレンスを確認するには、gccli --help を実行します。

一般的な操作：

  • gccli <email> calendars - すべてのカレンダーを一覧表示する
  • gccli <email> events <calendarId> [--from <dt>] [--to <dt>] - イベントを一覧表示する
  • gccli <email> event <calendarId> <eventId> - イベントの詳細を取得する
  • gccli <email> create <calendarId> --summary <s> --start <dt> --end <dt> - イベントを作成する
  • gccli <email> freebusy <calendarIds> --from <dt> --to <dt> - 予定の空き状況を確認する

メインのカレンダーには、calendarId として primary を使用します。

日付／時刻の形式

  • 時刻指定のイベント：YYYY-MM-DDTHH:MM:SSZ（UTC）または YYYY-MM-DDTHH:MM:SS（ローカル時刻）
  • 終日イベント：--all-day フラグと YYYY-MM-DD を使用します

データの保存先

  • ~/.gccli/credentials.json - OAuth クライアントの認証情報
  • ~/.gccli/accounts.json - アカウントのトークン

コメント

Markdown 対応