AIによるGoogleカレンダー自動化の設定

1. ブラウザで Google Cloud Consoleにアクセス；
2. わかりやすい名前（例：「gcalendar agent」）で新規プロジェクトを作成；
3. 初期化が完了したら新しいプロジェクトに切り替え。

0. プロンプトが表示された場合は「同意画面の構成」をクリック；
1. アプリケーション名を入力（例：「calendar mcp」）；
2. 承認済みメールアドレスを指定；
3. ユーザータイプの制限で「外部ユーザー」を選択；
4. 同じメールアドレスで連絡先情報を入力；
5. ユーザーデータポリシー要件に同意。

1. API とサービス → ライブラリに移動；
2. 「Calendar API」を検索；
3. 最初の結果を選択し、API アクセスを有効化；
4. API ステータスが「有効」と表示されていることを確認。

1. API とサービスの認証情報セクションにアクセス；
2. OAuth クライアント IDを作成；
3. アプリケーションタイプで「デスクトップアプリケーション」を選択；
4. 生成された JSON 認証情報ファイルをダウンロード；
5. ファイルをデスクトップに一時保存（任意）。

Claudeで、次のプロンプトをコピー＆ペーストします：

Create a new folder named projects in my Documents directory to store all MCP servers.
Then clone the repository using: git clone https://github.com/nspady/google-calendar-mcp.git into that folder.
After cloning, move the file gcp-oauth.keys.json from my Desktop into the cloned repo.

Claudeは自動的にprojectsフォルダを作成し、リポジトリをクローンし、認証情報のJSONファイルをリポジトリ内に移動します。

• Documentsフォルダを開く；
• 新しいprojectsフォルダが作成されているか確認；
• その中のクローンされたリポジトリ（例：google-calendar-mcp）フォルダを確認し、gcp-oauth.keys.jsonファイルがリポジトリ内に配置されていることを確認。

Claudeで次のプロンプトを実行します：

add next config block to claude config file
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }

• 設定を開く → ショートカット：MacはCmd + ,、WindowsはCtrl + ,；
• Developerタブに移動 → Edit Configをクリック；
• claude_desktop_config.jsonファイルをテキストエディタで開く。JSONファイルに新しい設定ブロックが追加され、認証情報ファイルへのパスが正しいことを確認；
• 正しければ、設定ウィンドウを閉じる。

• Claudeを完全に終了（Mac：Cmd + Q、Windows：Alt + F4）；
• アプリを再起動；
• 起動時にGoogle認証ページへリダイレクト：
  • プロジェクトで使用したのと同じGoogleアカウントを選択；
  • 許可を求められたら許可をクリック；
  • 認証成功の表示が出たらタブを閉じる。

ターミナル（Mac）またはコマンドライン（Windows）で、ルートディレクトリ（デフォルト）から開始し、今後のAIエージェント用ディレクトリを保存するフォルダへ移動します。

• フォルダにアクセスするには、cd folder_nameコマンドを使用します。例：

cd Documents

新しいフォルダを作成するには、mkdir new_folder_nameコマンドを使用します。例：

mkdir projects

この新しいフォルダに移動するには、cd commandコマンドを使います：

cd projects

git clone linkコマンドを使って GitHubリポジトリをクローンします：

git clone https://github.com/nspady/google-calendar-mcp.git

新しく作成されたリポジトリに移動するには、cdコマンドを使います：

cd google-calendar-mcp

次に、認証情報ファイルをAIエージェント（google_calendar_mcp）のフォルダに移動する必要があります。 ファイルエクスプローラーでファイルアイコンを開いたフォルダにドラッグ＆ドロップして手動で移動できます。 または、ターミナル／コマンドラインを使用し、次のコマンドでファイルをコピーします：cp path/to/file_name . 例：

cp ~/Desktop/gsp-oauth.keys.json .

末尾のドット（.）は現在のディレクトリを宛先として指定します。

ターミナルでlsコマンドを使い、ファイル名がリストに表示されているか確認することで、JSONファイルが正しく移動されたか確認できます。

ファイルを移動した後は、元の場所（例：デスクトップ）から削除してください。

ターミナル／コマンドラインで

npm install

このコマンドは、必要なパッケージと依存関係をすべてダウンロードします。

ターミナル／コマンドラインで作業を続け、次を実行します：

npm start

このコマンドは、プロジェクトのpackage.jsonファイルで定義されたデフォルトのスタートスクリプトを実行し、通常はアプリケーションやサーバーを起動します。本ケースでは認証フローが開始されます。

1. ブラウザウィンドウが自動的に開く；
2. 適切なGoogleアカウントを選択；
3. カレンダーアクセス権限を付与；
4. 「認証に成功しました」というメッセージを確認；
5. ブラウザウィンドウを閉じる。

Claude Desktop連携

• 設定ブロックをコピー：

    "google-calendar": {
      "command": "node",
      "args": [
        "/path/to/build/index.js"
      ]
    }

• Command/Ctrl + , → 「Developer」→「Edit Config」からClaude設定ファイルにアクセス；
• テキストエディタでclaude_desktop_config.jsonファイルを開く；
• 既存の設定ブロックの次、2つの閉じ中括弧の直前に新しい設定を追加；
• 各設定ブロックの後ろにはカンマを付け、最後のブロックのみカンマを付けないなど、正しいJSON構文を守ること。

ターミナル／コマンドラインで

pwd

を実行し、表示されたディレクトリのフルパスをコピーして、設定ファイル内の「/build」の前に挿入します。

設定ファイルはCommand/Ctrl + Sで保存します。

1. Claude Desktopを完全に再起動；
2. 新しいサーバーが利用可能なツールに表示されているか確認。