---
title: Google カレンダー
description: Google カレンダーのイベントを管理する
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="google_calendar"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Google カレンダー](https://calendar.google.com)は、Googleが提供する強力なカレンダーおよびスケジュールサービスで、イベント、会議、予定を管理するための包括的なプラットフォームを提供しています。Googleのエコシステム全体とのシームレスな統合と広範な普及により、Google カレンダーは個人的にも専門的にもスケジュール管理のニーズに対応する堅牢な機能を提供しています。

Google カレンダーでは、次のことができます：

- **イベントの作成と管理**：詳細情報を含む会議、予約、リマインダーのスケジュール設定
- **カレンダー招待の送信**：メール招待状を通じて参加者に自動的に通知し調整
- **自然言語によるイベント作成**：「明日の午後3時にジョンとミーティング」のような会話形式の言葉で素早くイベントを追加
- **イベントの表示と検索**：複数のカレンダーにわたって予定されたイベントを簡単に検索しアクセス
- **複数のカレンダーの管理**：様々なカレンダーにわたって異なるタイプのイベントを整理

Simでは、Google カレンダー連携によりエージェントがプログラムでカレンダーイベントを作成、読み取り、管理することができます。これにより、会議のスケジュール設定、カレンダー招待の送信、空き状況の確認、イベント詳細の管理などの強力な自動化シナリオが可能になります。エージェントは自然言語入力でイベントを作成し、参加者に自動カレンダー招待を送信し、イベント情報を取得し、今後のイベントをリストアップすることができます。この連携により、AIワークフローとカレンダー管理の間のギャップが埋められ、世界で最も広く使用されているカレンダープラットフォームの一つとのシームレスなスケジュール自動化と調整が可能になります。
{/* MANUAL-CONTENT-END */}

## 使用手順

Googleカレンダーをワークフローに統合します。カレンダーイベントの作成、読み取り、更新、一覧表示が可能です。OAuthが必要です。

## ツール

### `google_calendar_create`

Googleカレンダーに新しいイベントを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | いいえ | カレンダーID（デフォルトはプライマリ） |
| `summary` | string | はい | イベントのタイトル/概要 |
| `description` | string | いいえ | イベントの説明 |
| `location` | string | いいえ | イベントの場所 |
| `startDateTime` | string | はい | 開始日時。タイムゾーンオフセットを含める必要があります（例：2025-06-03T10:00:00-08:00）または、timeZoneパラメータを提供する |
| `endDateTime` | string | はい | 終了日時。タイムゾーンオフセットを含める必要があります（例：2025-06-03T11:00:00-08:00）または、timeZoneパラメータを提供する |
| `timeZone` | string | いいえ | タイムゾーン（例：America/Los_Angeles）。日時にオフセットが含まれていない場合は必須。提供されない場合はAmerica/Los_Angelesがデフォルト。 |
| `attendees` | array | いいえ | 参加者のメールアドレスの配列 |
| `sendUpdates` | string | いいえ | 参加者への更新通知方法：all（全員）、externalOnly（外部のみ）、またはnone（なし） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | イベント作成確認メッセージ |
| `metadata` | json | 作成されたイベントのメタデータ（ID、ステータス、詳細を含む） |

### `google_calendar_list`

Googleカレンダーからイベントを一覧表示する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | いいえ | カレンダーID（デフォルトはprimary） |
| `timeMin` | string | いいえ | イベントの下限（RFC3339タイムスタンプ、例：2025-06-03T00:00:00Z） |
| `timeMax` | string | いいえ | イベントの上限（RFC3339タイムスタンプ、例：2025-06-04T00:00:00Z） |
| `orderBy` | string | いいえ | 返されるイベントの順序（startTimeまたはupdated） |
| `showDeleted` | boolean | いいえ | 削除されたイベントを含める |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 見つかったイベント数の要約 |
| `metadata` | json | ページネーショントークンとイベント詳細を含むイベントリスト |

### `google_calendar_get`

Google カレンダーから特定のイベントを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | いいえ | カレンダーID（デフォルトはプライマリ） |
| `eventId` | string | はい | 取得するイベントID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | イベント取得確認メッセージ |
| `metadata` | json | ID、ステータス、時間、参加者を含むイベント詳細 |

### `google_calendar_quick_add`

自然言語テキストからイベントを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | いいえ | カレンダーID（デフォルトはプライマリ） |
| `text` | string | はい | イベントを説明する自然言語テキスト（例：「明日午後3時にジョンとミーティング」） |
| `attendees` | array | いいえ | 参加者のメールアドレスの配列（カンマ区切りの文字列も可） |
| `sendUpdates` | string | いいえ | 参加者への更新通知方法：all（全員）、externalOnly（外部のみ）、またはnone（なし） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 自然言語からのイベント作成確認メッセージ |
| `metadata` | json | 解析された詳細を含む作成されたイベントのメタデータ |

### `google_calendar_invite`

既存のGoogleカレンダーイベントに参加者を招待する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | いいえ | カレンダーID（デフォルトはプライマリ） |
| `eventId` | string | はい | 参加者を招待するイベントID |
| `attendees` | array | はい | 招待する参加者のメールアドレスの配列 |
| `sendUpdates` | string | いいえ | 参加者への更新通知方法：all、externalOnly、またはnone |
| `replaceExisting` | boolean | いいえ | 既存の参加者を置き換えるか追加するか（デフォルトはfalse） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | メール配信状況を含む参加者招待確認メッセージ |
| `metadata` | json | 参加者リストと詳細を含む更新されたイベントメタデータ |

## 注意事項

- カテゴリ: `tools`
- タイプ: `google_calendar`

イベントを別のカレンダーに移動します。API準拠のフィールドのみを返します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | いいえ | 移動元のGoogleカレンダーID（例：primaryまたはcalendar@group.calendar.google.com） |
| `eventId` | string | はい | 移動するGoogleカレンダーイベントID |
| `destinationCalendarId` | string | はい | 移動先のGoogleカレンダーID |
| `sendUpdates` | string | いいえ | 参加者への更新通知方法：all（全員）、externalOnly（外部のみ）、またはnone（なし） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `id` | string | イベントID |
| `htmlLink` | string | イベントリンク |
| `status` | string | イベントステータス |
| `summary` | string | イベントタイトル |
| `description` | string | イベント説明 |
| `location` | string | イベント場所 |
| `start` | json | イベント開始 |
| `end` | json | イベント終了 |
| `attendees` | json | イベント参加者 |
| `creator` | json | イベント作成者 |
| `organizer` | json | イベント主催者 |

### `google_calendar_instances`

Googleカレンダーから繰り返しイベントのインスタンスを取得します。API準拠のフィールドのみを返します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | いいえ | GoogleカレンダーID（例：primaryまたはcalendar@group.calendar.google.com） |
| `eventId` | string | はい | インスタンスを取得する繰り返しイベントID |
| `timeMin` | string | いいえ | インスタンスの下限（RFC3339タイムスタンプ、例：2025-06-03T00:00:00Z） |
| `timeMax` | string | いいえ | インスタンスの上限（RFC3339タイムスタンプ、例：2025-06-04T00:00:00Z） |
| `maxResults` | number | いいえ | 返すインスタンスの最大数（デフォルト250、最大2500） |
| `pageToken` | string | いいえ | 結果の次のページを取得するためのトークン |
| `showDeleted` | boolean | いいえ | 削除されたインスタンスを含める |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `nextPageToken` | string | 次のページトークン |
| `timeZone` | string | カレンダーのタイムゾーン |
| `instances` | json | 繰り返しイベントのインスタンスのリスト |

### `google_calendar_list_calendars`

ユーザーのすべてのカレンダーを一覧表示する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `minAccessRole` | string | いいえ | 返されるカレンダーの最小アクセスロール：freeBusyReader、reader、writer、またはowner |
| `maxResults` | number | いいえ | 返すカレンダーの最大数（デフォルト100、最大250） |
| `pageToken` | string | いいえ | 結果の次のページを取得するためのトークン |
| `showDeleted` | boolean | いいえ | 削除されたカレンダーを含める |
| `showHidden` | boolean | いいえ | 非表示のカレンダーを含める |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `nextPageToken` | string | 次のページトークン |
| `calendars` | array | カレンダーのリスト |
|   ↳ `id` | string | カレンダーID |
|   ↳ `summary` | string | カレンダーのタイトル |
|   ↳ `description` | string | カレンダーの説明 |
|   ↳ `location` | string | カレンダーの場所 |
|   ↳ `timeZone` | string | カレンダーのタイムゾーン |
|   ↳ `accessRole` | string | カレンダーのアクセスロール |
|   ↳ `backgroundColor` | string | カレンダーの背景色 |
|   ↳ `foregroundColor` | string | カレンダーの前景色 |
|   ↳ `primary` | boolean | これがプライマリカレンダーかどうか |
|   ↳ `hidden` | boolean | カレンダーが非表示かどうか |
|   ↳ `selected` | boolean | カレンダーが選択されているかどうか |

### `google_calendar_quick_add`

自然言語テキストからイベントを作成します。API準拠のフィールドのみを返します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | いいえ | GoogleカレンダーID（例：primaryまたはcalendar@group.calendar.google.com） |
| `text` | string | はい | イベントを説明する自然言語テキスト（例：「明日午後3時にJohnとミーティング」） |
| `attendees` | array | いいえ | 参加者のメールアドレスの配列（カンマ区切りの文字列も可） |
| `sendUpdates` | string | いいえ | 参加者への更新通知方法：all（全員）、externalOnly（外部のみ）、またはnone（なし） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `id` | string | イベントID |
| `htmlLink` | string | イベントリンク |
| `status` | string | イベントステータス |
| `summary` | string | イベントタイトル |
| `description` | string | イベント説明 |
| `location` | string | イベント場所 |
| `start` | json | イベント開始 |
| `end` | json | イベント終了 |
| `attendees` | json | イベント参加者 |
| `creator` | json | イベント作成者 |
| `organizer` | json | イベント主催者 |

### `google_calendar_invite`

既存のGoogleカレンダーイベントに参加者を招待します。API準拠のフィールドのみを返します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | いいえ | GoogleカレンダーID（例：primaryまたはcalendar@group.calendar.google.com） |
| `eventId` | string | はい | 参加者を招待するGoogleカレンダーイベントID |
| `attendees` | array | はい | 招待する参加者のメールアドレスの配列 |
| `sendUpdates` | string | いいえ | 参加者への更新通知方法：all（全員）、externalOnly（外部のみ）、またはnone（なし） |
| `replaceExisting` | boolean | いいえ | 既存の参加者を置き換えるか追加するか（デフォルトはfalse） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `id` | string | イベントID |
| `htmlLink` | string | イベントリンク |
| `status` | string | イベントステータス |
| `summary` | string | イベントタイトル |
| `description` | string | イベント説明 |
| `location` | string | イベント場所 |
| `start` | json | イベント開始 |
| `end` | json | イベント終了 |
| `attendees` | json | イベント参加者 |
| `creator` | json | イベント作成者 |
| `organizer` | json | イベント主催者 |
