calcom-access

Cal.com アクセス

Claude Code を使用して、Cal.com の予約とイベントタイプをプログラムから管理します。

自己進化型スキル：このスキルは使用することで改善されます。手順が間違っている場合、パラメーターが変化している場合、または回避策が必要だった場合は、先送りせずにこのファイルを直ちに修正してください。実際に再現可能な問題がある場合にのみ更新してください。

必須の事前確認（Cal.com の操作前に実行）

重要：Cal.com のコマンドを実行する前に、この事前確認チェックリストを必ず完了してください。手順を省略しないでください。

手順 1：CLI バイナリの存在を確認

ls -la "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom" 2>/dev/null || echo "BINARY_NOT_FOUND"

BINARY_NOT_FOUND の場合：まずビルドしてください。

cd ~/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli && bun install && bun run build

手順 2：CALCOM_OP_UUID 環境変数を確認

echo "CALCOM_OP_UUID: ${CALCOM_OP_UUID:-NOT_SET}"

NOT_SET の場合：以下のセットアップフローを必ず実行してください。Cal.com コマンドに進まないでください。

手順 3：1Password の認証を確認

op account list 2>&1 | head -3

エラーが発生した場合、またはサインインしていない場合：まず op signin を実行するようユーザーに伝えてください。

手順 4：API 接続をテスト

CALCOM_CLI="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom"
$CALCOM_CLI event-types list 2>&1 | head -5

---

セットアップフロー（CALCOM_OP_UUID が NOT_SET の場合）

以下の手順を順番どおりに実行してください。判断が必要な箇所では AskUserQuestion を使用してください。

セットアップ手順 1：1Password CLI を確認

command -v op && echo "OP_CLI_INSTALLED" || echo "OP_CLI_MISSING"

OP_CLI_MISSING の場合：中止し、ユーザーに次のように伝えてください。

1Password CLI が必要です。brew install 1password-cli でインストールしてください。

セットアップ手順 2：1Password 内の Cal.com API キーを検索

op item list --vault "Claude Automation" --format json 2>/dev/null | jq -r '.[] | select(.title | test("calcom|cal.com|calendar"; "i")) | "\(.id)\t\(.title)"'

出力を解析し、結果に応じて進めてください。

セットアップ手順 3：ユーザーが API 認証情報を選択

項目が見つかった場合は、見つかった項目を使って AskUserQuestion を使用してください。

項目が見つからなかった場合は、ユーザーに次の手順を案内してください。

1. Cal.com のインスタンス（セルフホストまたは cal.com）にログインします。
2. ［Settings］>［Developer］>［API Keys］に移動します。
3. 適切なスコープを指定して、新しい API キーを生成します。
4. 1Password の Claude Automation vault に保存します。

op item create --category "API Credential" --title "Cal.com API Key" \
  --vault "Claude Automation" \
  "credential=<api-key>" \
  "api_url=<cal.com-instance-url>"

セットアップ手順 4：UUID を指定

ユーザーが UUID を含む項目を選択したら、AskUserQuestion を使用して、どこに設定するか確認してください。このシェルのみ（export CALCOM_OP_UUID=<selected-uuid>）に設定するか、launchd デーモンに設定するかを確認します。後者の場合、~/gh/<org>/<automation-repo>/.env.launchd に export CALCOM_OP_UUID='<selected-uuid>' を追加します。このファイルはランチャースクリプトによって読み込まれます。

セットアップ手順 5：確認

echo "CALCOM_OP_UUID: ${CALCOM_OP_UUID:-NOT_SET}"

セットアップ手順 6：接続をテスト

CALCOM_OP_UUID="${CALCOM_OP_UUID}" $HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom event-types list

---

Cal.com コマンド（事前確認に合格した後のみ）

CALCOM_CLI="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom"

# List event types
$CALCOM_CLI event-types list

# List bookings
$CALCOM_CLI bookings list -n 10

# List bookings by status
$CALCOM_CLI bookings list --status upcoming -n 20

# Get booking details
$CALCOM_CLI bookings get <booking_id>

# Create event type
$CALCOM_CLI event-types create --title "30min Interview" --slug "interview-30" --length 30

# Update event type
$CALCOM_CLI event-types update <event_type_id> --title "Updated Title"

# List schedules (availability)
$CALCOM_CLI schedules list

# JSON output (for parsing)
$CALCOM_CLI bookings list -n 10 --json

Cal.com API v2 リファレンス

エンドポイント	CLI コマンド	説明
イベントタイプ	event-types list	すべてのイベントタイプを一覧表示
イベントタイプ	event-types create	新しいイベントタイプを作成
予約	bookings list	予約を一覧表示
予約	bookings get	予約の詳細を取得
予約	bookings cancel	予約をキャンセル
スケジュール	schedules list	空き時間枠を一覧表示
スケジュール	schedules create	空き状況を作成
空き状況	availability check	時間枠の空き状況を確認

環境変数

変数	必須	説明
CALCOM_OP_UUID	はい	API キー用の 1Password 項目 UUID
CALCOM_API_URL	いいえ	API のベース URL（デフォルト：セルフホスト）

参考資料

• calcom-api-setup.md - Cal.com API キーのセットアップガイド
• env-setup.md - 利用者ごとの各変数の設定元

変更後のチェックリスト

• YAML frontmatter が有効（description にコロンがない）
• トリガーキーワードが最新
• パスのパターンでハードコードされたパスではなく $HOME を使用
• 参考資料が存在し、リンクされている

実行後の振り返り

このスキルの実行後、タスクを終える前に振り返ります。

0. 現在地を確認します。 — 編集する前に、この SKILL.md の正規パスを特定します。
1. 何が失敗しましたか？ — 原因となった指示を修正します。
2. 予想以上にうまくいったことは何ですか？ — 推奨プラクティスにします。
3. 何にずれがありましたか？ — 現状と合わなくなったスクリプト、参照、依存関係を修正します。
4. 記録します。 — 発生のきっかけ、修正内容、根拠を含む進化ログのエントリーを追加します。

先延ばしにしないでください。次回の実行では、ここに残した内容が引き継がれます。