jpskill.com
🛠️ 開発・MCP コミュニティ 🔴 エンジニア向け 👤 エンジニア・AI開発者

🛠️ Google Calendar

google-calendar

Googleカレンダーと連携し、今後の予定を確認したり、

⚡ ⏱ 障害ポストモーテム 1日 → 1時間

📺 まず動画で見る(YouTube)

▶ 【衝撃】最強のAIエージェント「Claude Code」の最新機能・使い方・プログラミングをAIで効率化する超実践術を解説! ↗

※ jpskill.com 編集部が参考用に選んだ動画です。動画の内容と Skill の挙動は厳密には一致しないことがあります。

📜 元の英語説明(参考)

Interact with Google Calendar via the Google Calendar API – list upcoming events, create new events, update or delete them. Use this skill when you need programmatic access to your calendar from OpenClaw.

🇯🇵 日本人クリエイター向け解説

一言でいうと

Googleカレンダーと連携し、今後の予定を確認したり、

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o google-calendar.zip https://jpskill.com/download/4869.zip && unzip -o google-calendar.zip && rm google-calendar.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/4869.zip -OutFile "$d\google-calendar.zip"; Expand-Archive "$d\google-calendar.zip" -DestinationPath $d -Force; ri "$d\google-calendar.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して google-calendar.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → google-calendar フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-18
同梱ファイル
4

💬 こう話しかけるだけ — サンプルプロンプト

  • › Google Calendar を使って、最小構成のサンプルコードを示して
  • › Google Calendar の主な使い方と注意点を教えて
  • › Google Calendar を既存プロジェクトに組み込む方法を教えて

これをClaude Code に貼るだけで、このSkillが自動発動します。

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Google Calendar Skill

概要

このスキルは、Google Calendar REST API の薄いラッパーを提供します。これにより、以下のことが可能になります。

  • 今後のイベントを一覧表示する（オプションで時間範囲またはクエリでフィルタリング可能）
  • タイトル、開始/終了時刻、説明、場所、および参加者を含む新しいイベントを追加する
  • 既存のイベントをその ID で更新する
  • イベントをその ID で削除する

このスキルは Python (scripts/google_calendar.py) で実装されています。以下の環境変数が設定されていることを想定しています（openclaw secret set を使用して安全に保存できます）。

GOOGLE_CLIENT_ID=…
GOOGLE_CLIENT_SECRET=…
GOOGLE_REFRESH_TOKEN=…   # OAuth 同意後に取得
GOOGLE_CALENDAR_ID=primary   # または特定のカレンダーの ID

スキルを初めて実行する際には、リフレッシュトークンを取得するために OAuth フローを実行する必要がある場合があります。詳細については、以下の「セットアップ」セクションを参照してください。

コマンド

google-calendar list [--from <ISO> --to <ISO> --max <N>]
google-calendar add   --title <title> [--start <ISO> --end <ISO>]
                     [--desc <description> --location <loc> --attendees <email1,email2>]
google-calendar update --event-id <id> [--title <title> ... other fields]
google-calendar delete --event-id <id>

すべてのコマンドは、標準出力に JSON ペイロードを返します。エラーは標準エラーに出力され、ゼロ以外の終了コードを返します。

セットアップ

  1. Google Cloud プロジェクトを作成し、Google Calendar API を有効にします。
  2. OAuth 認証情報を作成します（タイプは Desktop app）。client_id と client_secret をメモしておきます。
  3. ヘルパースクリプトを実行してリフレッシュトークンを取得します。
    GOOGLE_CLIENT_ID=… GOOGLE_CLIENT_SECRET=… python3 -m google_calendar.auth

    これによりブラウザが開かれ（または別の場所で開くことができる URL が表示され）、アクセスを許可するように求められます。承認後、表示される refresh_token をコピーします。

  4. 認証情報を安全に保存します。
    openclaw secret set GOOGLE_CLIENT_ID <value>
openclaw secret set GOOGLE_CLIENT_SECRET <value>
openclaw secret set GOOGLE_REFRESH_TOKEN <value>
openclaw secret set GOOGLE_CALENDAR_ID primary   # オプション
  5. 必要な Python パッケージをインストールします（一度だけ）。
    pip install --user google-auth google-auth-oauthlib google-api-python-client

仕組み（概要）

スクリプトは環境から認証情報をロードし、リフレッシュトークンを使用してアクセストークンを更新し、service = build('calendar', 'v3', credentials=creds) を構築し、適切な API メソッドを呼び出します。

参考文献

注: このスキルは GUI を必要としません。完全に HTTP 呼び出しを介して動作するため、ヘッドレスサーバーに適しています。

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Google Calendar Skill

Overview

This skill provides a thin wrapper around the Google Calendar REST API. It lets you:

  • list upcoming events (optionally filtered by time range or query)
  • add a new event with title, start/end time, description, location, and attendees
  • update an existing event by its ID
  • delete an event by its ID

The skill is implemented in Python (scripts/google_calendar.py). It expects the following environment variables to be set (you can store them securely with openclaw secret set):

GOOGLE_CLIENT_ID=…
GOOGLE_CLIENT_SECRET=…
GOOGLE_REFRESH_TOKEN=…   # obtained after OAuth consent
GOOGLE_CALENDAR_ID=primary   # or the ID of a specific calendar

The first time you run the skill you may need to perform an OAuth flow to obtain a refresh token – see the Setup section below.

Commands

google-calendar list [--from <ISO> --to <ISO> --max <N>]
google-calendar add   --title <title> [--start <ISO> --end <ISO>]
                     [--desc <description> --location <loc> --attendees <email1,email2>]
google-calendar update --event-id <id> [--title <title> ... other fields]
google-calendar delete --event-id <id>

All commands return a JSON payload printed to stdout. Errors are printed to stderr and cause a non‑zero exit code.

Setup

  1. Create a Google Cloud project and enable the Google Calendar API.
  2. Create OAuth credentials (type Desktop app). Note the client_id and client_secret.
  3. Run the helper script to obtain a refresh token:
    GOOGLE_CLIENT_ID=… GOOGLE_CLIENT_SECRET=… python3 -m google_calendar.auth

    It will open a browser (or print a URL you can open elsewhere) and ask you to grant access. After you approve, copy the refresh_token it prints.

  4. Store the credentials securely:
    openclaw secret set GOOGLE_CLIENT_ID <value>
openclaw secret set GOOGLE_CLIENT_SECRET <value>
openclaw secret set GOOGLE_REFRESH_TOKEN <value>
openclaw secret set GOOGLE_CALENDAR_ID primary   # optional
  5. Install the required Python packages (once):
    pip install --user google-auth google-auth-oauthlib google-api-python-client

How it works (brief)

The script loads the credentials from the environment, refreshes the access token using the refresh token, builds a service = build('calendar', 'v3', credentials=creds), and then calls the appropriate API method.

References

Note: This skill does not require a GUI; it works entirely via HTTP calls, so it is suitable for headless servers.

同梱ファイル

※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。