Calcom MCP

🚀 Cal.com FastMCPサーバー

このプロジェクトは、Cal.com APIとやり取りするためのFastMCPサーバーを提供します。言語学習モデル（LLMs）が、イベントタイプの管理や予約などの重要なCal.comの機能に接続するためのツールを使用できるようにします。

⚠️ 重要な注意

このプロジェクトはCal.comと関連付けられている、またはCal.comによって承認されたものではありません。私は独立した開発者であり、公式の立場でCal.comと関連することは一切ありません。

🚀 クイックスタート

このセクションでは、Cal.com FastMCPサーバーをセットアップして実行する手順を説明します。

📦 インストール

前提条件

• Python 3.8+
• Cal.comアカウントとAPIキー（v2）

セットアップ手順

1. リポジトリをクローンする（該当する場合）またはファイルをダウンロードする。

   git clone https://github.com/Danielpeter-99/calcom-mcp.git
   cd calcom-mcp
   

2. 仮想環境を作成する（推奨）：

   python -m venv venv
   source venv/bin/activate  # Windowsの場合: venv\Scripts\activate
   

3. 依存関係をインストールする：

   pip install -r requirements.txt
   

4. Cal.com APIキーを設定する： CALCOM_API_KEY環境変数を設定する必要があります。APIキーはCal.comの設定ページ（通常は開発者またはセキュリティ設定の下）から取得できます。

   • Linux/macOS：

     export CALCOM_API_KEY="your_actual_api_key_here"
     

     これを永続的に設定するには、シェルの設定ファイル（例：.bashrc, .zshrc）にこの行を追加します。

   • Windows (PowerShell)：

     $env:CALCOM_API_KEY="your_actual_api_key_here"
     

     これを永続的に設定するには、システムのプロパティ > 環境変数を通じて設定できます。

💻 使用例

サーバーの起動

セットアップが完了したら、FastMCPサーバーを実行できます。

fastmcp run app.py --transport sse --port 8010

サーバーはlocalhost:8010で起動し、実行中であることを示す出力が表示されます。CALCOM_API_KEYが設定されていない場合、警告が表示されます。

利用可能なツール

サーバーは現在、LLMとのやり取りのために以下のツールを提供しています。

• get_api_status(): 環境にCal.com APIキーが設定されているかを確認します。ステータスを示す文字列を返します。
• list_event_types(): 認証されたアカウントのCal.comからすべてのイベントタイプのリストを取得します。イベントタイプのリストまたはエラーメッセージを含む辞書を返します。
• get_bookings(...): Cal.comから予約のリストを取得します。オプションのフィルター（event_type_id, user_id, status, date_from, date_to, limit）があります。予約のリストまたはエラーメッセージを含む辞書を返します。
• create_booking(...): 特定のイベントタイプと参加者のためにCal.comに新しい予約を作成します。開始時間、参加者の詳細、イベントタイプの識別子などのパラメーターが必要です。予約の詳細またはエラーメッセージを含む辞書を返します。
• list_schedules(...): 認証されたユーザーまたは特定のユーザー/チームが利用可能なすべてのスケジュールをリストします。オプションのフィルター：user_id, team_id, limit。スケジュールのリストまたはエラーメッセージを含む辞書を返します。
• list_teams(...): 認証されたユーザーが利用可能なすべてのチームをリストします。オプションのフィルター：limit。チームのリストまたはエラーメッセージを含む辞書を返します。
• list_users(...): 認証されたアカウントが利用可能なすべてのユーザーをリストします。オプションのフィルター：limit。ユーザーのリストまたはエラーメッセージを含む辞書を返します。
• list_webhooks(...): 認証されたアカウントに設定されたすべてのウェブフックをリストします。オプションのフィルター：limit。ウェブフックのリストまたはエラーメッセージを含む辞書を返します。

注意: すべてのツールは、CALCOM_API_KEY環境変数が設定されている必要があります。設定されていない場合、ツールは構造化されたエラーメッセージを返します。

ツールの使用とエラー処理

• すべてのツールは、APIの応答（辞書または文字列）または失敗の詳細を含む構造化されたエラーメッセージを返します。
• エラーメッセージには、エラーの種類、HTTPステータスコード（該当する場合）、およびCal.com APIからの応答テキストが含まれます。
• 最適な結果を得るために、返されたデータを使用する前に、応答にerrorキーが存在するかを常に確認してください。
• ツールは、成功したAPI呼び出しと失敗したAPI呼び出しの両方について有益なフィードバックを提供するように堅牢に設計されています。

🔧 技術詳細

• Cal.com APIのベースURLはhttps://api.cal.com/v2に設定されています。
• 認証は主にCALCOM_API_KEYを使用したベアラートークンで処理されます。
• create_bookingツールは、Cal.com API v2ドキュメントでそのエンドポイントに指定されているように、cal-api-version: 2024-08-13ヘッダーを使用します。
• API呼び出しにはエラー処理が含まれており、有益な応答を提供します。

🚀 構築に使用されたもの

📄 ライセンス

⚠️ 重要なセキュリティ注意

CALCOM_API_KEYをソースコードに直接ハードコードしないでください。セットアップ手順で説明されているように、常に環境変数を使用してAPIキーを安全に保管してください。