Cal.com Calendar

🚀 Cal.comカレンダーMCPサーバー

Cal.comカレンダーAPIを統合したMCPサーバーの実装で、予約スケジューリング機能を提供します。

✨ 主な機能

• 予約の追加：新しいカレンダー会議を予約し、参加者の詳細情報を含めることができます。
• 予約の更新：既存の予約詳細（時間やメモなど）を変更できます。
• 予約の削除：既存の予約をキャンセルして削除します。
• 予約の一覧表示：特定の日付範囲内の予約済みの会議を表示します。

📦 インストール

ツール

• calcom_add_appointment

  • 新しいカレンダー会議を作成します。
  • 入力パラメータ：
    • eventTypeId（数値）：Cal.comのイベントタイプID
    • startTime（文字列）：開始時間（ISO形式：YYYY-MM-DDTHH:mm:ss.sssZ）
    • endTime（文字列）：終了時間（ISO形式：YYYY-MM-DDTHH:mm:ss.sssZ）
    • name（文字列）：参加者の名前
    • email（文字列）：参加者のメールアドレス
    • notes（文字列、オプション）：会議のメモ

• calcom_update_appointment

  • 既存のカレンダー会議を更新します。
  • 入力パラメータ：
    • bookingId（数値）：更新するCal.comの予約ID
    • startTime（文字列、オプション）：新しい開始時間（ISO形式）
    • endTime（文字列、オプション）：新しい終了時間（ISO形式）
    • notes（文字列、オプション）：新しいメモ

• calcom_delete_appointment

  • 既存のカレンダー会議を削除します。
  • 入力パラメータ：
    • bookingId（数値）：削除するCal.comの予約ID
    • reason（文字列、オプション）：削除理由

• calcom_list_appointments

  • 日付範囲内のカレンダー予約を一覧表示します。
  • 入力パラメータ：
    • startDate（文字列）：開始日（形式：YYYY-MM-DD）
    • endDate（文字列）：終了日（形式：YYYY-MM-DD）

設定

APIキーの取得

1. Cal.comで新しいアカウントを登録します。
2. 設定 > 開発者 > APIキーにアクセスします。
3. 新しいAPIキーを生成し、適切な権限を付与します。

Claude Desktopを使用した設定

claude_desktop_config.jsonに以下の内容を追加します。

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CALCOM_API_KEY",
        "mcp/calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPXを使用した設定

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

ビルド

Dockerを使用してビルドします。

docker build -t mcp/calcom-calendar:latest -f Dockerfile .

📄 ライセンス

このMCPサーバーはMITライセンスの下で提供されています。これは、MITライセンスの条項と条件に従い、自由にソフトウェアを使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。