# Google Calendar Tool

> Googleカレンダー連携ツール。予定の一覧取得・作成をOAuth2でCalendar API経由で行う。 Use when: 予定の確認、新規イベント作成、スケジュール変更、カレンダー同期が必要なとき。

- Skill: `xuiltul/google-calendar-tool` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xuiltul/google-calendar-tool`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xuiltul/google-calendar-tool/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: xuiltul (https://skillmd.com/u/xuiltul)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/xuiltul/google-calendar-tool

---


# Google Calendar ツール

GoogleカレンダーのイベントをOAuth2で直接操作する外部ツール。

## 呼び出し方法

**Bash**: `animaworks-tool google_calendar <サブコマンド> [引数]` で実行

## アクション一覧

### list — 予定一覧取得
```bash
animaworks-tool google_calendar list [-n 20] [-d 7] [--calendar-id primary]
```

| パラメータ | 型 | デフォルト | 説明 |
|-----------|-----|-----------|------|
| max_results | integer | 20 | 最大取得件数 |
| days | integer | 7 | 何日先まで取得するか |
| calendar_id | string | "primary" | カレンダーID |

### add — 予定追加
```bash
animaworks-tool google_calendar add "会議" --start 2026-03-04T10:00:00+09:00 --end 2026-03-04T11:00:00+09:00
```

| パラメータ | 型 | 必須 | 説明 |
|-----------|-----|------|------|
| summary | string | Yes | イベントタイトル |
| start | string | Yes | 開始時刻（ISO8601またはYYYY-MM-DD） |
| end | string | Yes | 終了時刻（ISO8601またはYYYY-MM-DD） |
| description | string | No | 詳細説明 |
| location | string | No | 場所 |
| calendar_id | string | No | カレンダーID（デフォルト: primary） |
| attendees | array | No | 参加者メールアドレスのリスト |

## CLI使用法

```bash
animaworks-tool google_calendar list [-n 20] [-d 7] [--calendar-id primary]
animaworks-tool google_calendar add "会議" --start 2026-03-04T10:00:00+09:00 --end 2026-03-04T11:00:00+09:00
```

## 注意事項

- 初回使用時にOAuth2認証フローが必要
- credentials.json を ~/.animaworks/credentials/google_calendar/ に配置すること
- 終日イベントは start/end を YYYY-MM-DD 形式で指定