Calendesk

Calendesk MCP サーバー

Calendesk の予約プラットフォームを Claude、Claude Desktop、Claude Code、その他の MCP 対応 AI ツールに接続します。予約、顧客、従業員、サービスの管理や、ビジネス分析の確認をすべて自然言語で行えます。32 個のツール、OAuth サインイン、Calendesk アカウントの外部にデータが出ることはありません。

前提条件

• Calendesk アカウント

セットアップ

Claude.ai（推奨）

インストールや API キーは不要です。安全な認証には OAuth を使用します。

1. Claude.ai の Settings → Connectors に移動します
2. Add custom connector をクリックします
3. 次の情報を入力します：
   • Name: Calendesk
   • Remote MCP server URL: https://claude.calendesk.com
4. Add をクリックします
5. プロンプトが表示されたら、Calendesk の認証情報でログインします（OAuth のため、コピーする API キーはありません）

Claude Desktop

設定ファイル（macOS/Linux では ~/.config/claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）に追加します：

{
    "mcpServers": {
        "calendesk": {
            "url": "https://mcp.calendesk.com",
            "headers": {
                "X-Api-Key": "your-api-key",
                "X-Tenant": "your-tenant-id"
            }
        }
    }
}

Admin Panel → Settings → API で API キーを生成します。

Claude Code

claude mcp add calendesk https://mcp.calendesk.com \
  --transport http \
  --header "X-Api-Key: your-key" \
  --header "X-Tenant: your-tenant"

その他の MCP クライアント（STDIO プロキシ）

HTTP トランスポートに対応していないクライアントの場合：

pip install calendesk-mcp-server
# or: uvx calendesk-mcp-server

{
    "mcpServers": {
        "calendesk": {
            "command": "uvx",
            "args": ["calendesk-mcp-server"],
            "env": {
                "CALENDESK_API_KEY": "your-api-key",
                "CALENDESK_TENANT": "your-tenant-id"
            }
        }
    }
}

対応ツール

イベントと予約

• list_events - フィルターを指定して、カレンダーイベント（予約、ブロック／休暇、グループ予約）を一覧表示します
• get_booking - ID を指定して、特定の予約の詳細を取得します
• create_booking - 新しい予約／アポイントメントを作成します
• update_booking - 既存の予約を更新します
• delete_booking - 予約を削除します
• get_group_booking - グループ予約の詳細を取得します
• check_event_overlaps - スケジュールの競合を確認します
• get_unavailable_slot - ブロック／休暇枠の詳細を取得します
• create_unavailable_slot - 従業員のブロック／休暇を作成します
• update_unavailable_slot - ブロック／休暇枠を更新します
• delete_unavailable_slot - ブロック／休暇枠を削除します

顧客

• search_users - 名前、メールアドレス、電話番号で顧客を検索します
• get_user - ID を指定して、顧客の詳細を取得します
• list_users - オプションのフィルターを指定して、すべての顧客を一覧表示します
• create_user - 新しい顧客を作成します
• update_user - 顧客情報を更新します
• delete_user - 顧客を削除します

従業員

• list_employees - すべての従業員／スタッフを一覧表示します
• get_employee - 従業員の詳細を取得します
• delete_employee - 従業員を削除します

サービスと空き状況

• list_services - 利用可能なすべてのサービスを一覧表示します
• get_service - 所要時間、価格、場所など、サービスの詳細を取得します
• get_available_slots - 予約可能な時間枠を取得します
• list_availability - 空き状況のスケジュール／営業時間を取得します
• get_availability - 特定の空き状況スケジュールを取得します
• list_service_types - 各サービスを含むすべてのサービスカテゴリを取得します
• list_products - 販売可能なすべての商品を取得します
• list_tags - 利用可能なすべてのタグを取得します

分析と統計

• get_stats - ビジネス分析：ダッシュボードの KPI、売上、予約、従業員のパフォーマンス、サービス、顧客、パターン、支払い、サブスクリプション、場所、商品、予測。type パラメーターでレポートを選択します。

設定と通知

• get_settings - ビジネス設定（タイムゾーン、通貨、会社情報）を取得します
• get_me - 現在のユーザープロフィールと従業員情報を取得します
• send_notification - メール、SMS、またはプッシュ通知を送信します

権限とアクセス

アクセス権は Calendesk のロールと権限に準じます。コネクターが実行できるのは、Calendesk ユーザーとして管理パネルで実行できる操作のみです。アカウントを接続した従業員には、ログインしたときに表示されるものだけが表示され、それ以外は表示されません。

• 読み取りツール（一覧表示、閲覧、検索、分析）は、追加の確認なしで実行されます。
• 書き込みツール（予約、顧客、ブロックの作成／更新／削除、通知の送信）は破壊的な操作としてマークされているため、実行のたびに Claude が確認を求めます。

メールアドレスが複数の Calendesk 企業に登録されている場合は、サインイン時に接続先を選択します。すべてのツール呼び出しは、その単一テナントの範囲内で実行されます。

データの取り扱いとセキュリティ

• ファーストパーティのみ。 すべてのツール呼び出しは、HTTPS 経由で Calendesk 独自の API に送信されます。サードパーティのサービスは関与せず、データが販売または共有されることもありません。
• お客様のアカウントデータのみ。 サーバーは、お客様の Calendesk アカウント内の予約、顧客、従業員、サービス、設定、分析データを読み取り、書き込みます。お客様のテナント外のデータに触れることはありません。
• OAuth を使用し、共有キーは不要です。 Claude.ai は OAuth 2.1（認可コード＋PKCE、Dynamic Client Registration を使用）で接続します。アクセストークンとリフレッシュトークンは Calendesk が発行し、お客様に代わって Calendesk API を呼び出す場合にのみ使用されます。セルフホスト可能な構成では、お客様自身が生成した API キーとテナント ID を使用します。
• 会話は保存されません。 サーバーは各ツール呼び出しを処理し、結果を返します。お客様の会話、チャット履歴、メッセージを保存、記録、転送することはありません。
• 管理権限はお客様にあります。 Claude.ai の「設定」→「コネクター」からいつでもコネクターを切断できます。または、Calendesk 管理パネルで API キーを無効化できます。

データの収集と保持については、Calendesk プライバシーポリシーをご覧ください。

使用例

今日のスケジュールを確認する

お客様：「今日のスケジュールを教えてください。」

アシスタントは今日の日付を指定して list_events を呼び出し、次の結果を返します。

本日の予約は 4 件です：

時刻	サービス	顧客	ステータス
09:00–10:00	ヘアカット	Maria Kowalska	承認済み
10:30–11:30	ヘアカラー	Anna Wiśniewska	承認済み
13:00–14:00	ヘアカット	Jan Nowak	承認済み
15:00–16:00	ひげのトリミング	Tomasz Zieliński	承認済み

空き枠を探して予約する

お客様：「来週、Kowalski 医師との 60 分の相談を予約できる時間はいつですか？」

アシスタントはサービスと従業員を指定して get_available_slots を呼び出し、次のように回答します。

Kowalski 医師には、来週、次の空きがあります：

月曜日： 09:00、11:00、14:00 火曜日： 10:00、13:00、15:00 木曜日： 09:00、11:00

この中から予約しますか？

お客様：「月曜日の 11:00 に、[email protected] の顧客を予約してください。」

アシスタントは search_users を呼び出して顧客を検索し、次に check_event_overlaps を呼び出して予約の重複がないことを確認してから、create_booking を呼び出します。

予約が確定しました：

• サービス： 相談（60 分）
• 従業員： Kowalski 医師
• 顧客： Anna Wiśniewska（[email protected]）
• 日時： 3 月 17 日（月）11:00–12:00
• 予約 ID： #4521

事業の実績を確認する

お客様：「先月の事業実績を、その前の月と比較するとどうでしたか？」

アシスタントは日付範囲を指定して get_stats（ダッシュボードレポート）を呼び出します。

2026 年 2 月と 2026 年 1 月の比較：

指標	2 月	増減
売上	€12 500	+8.5%
予約数	285	+12
新規顧客数	18	+5
キャンセル率	3.5%	−0.8pp

売上は増加傾向にあり、主な要因はヘアカラーの予約増加（+22%）です。

顧客を検索する

お客様：「Kowalska という顧客の連絡先を探してください。」

アシスタントは search_users を呼び出します。

2 件見つかりました：

1. Maria Kowalska — [email protected]、+48 512 345 678（最終来店：3 月 5 日）
2. Ewa Kowalska — [email protected]、+48 601 234 567（最終来店：2 月 12 日）

通知を送信する

あなた：「Maria Kowalska に、明日の予約についてメールでリマインダーを送信してください」

アシスタントが send_notification を呼び出します：

Maria Kowalska（[email protected]）に、明日 09:00 のヘアカットの予約についてリマインダーを記載したメールを送信しました。

環境変数（STDIO モードのみ）

変数	必須	説明
CALENDESK_API_KEY	はい	Calendesk 管理パネルで取得した API キー
CALENDESK_TENANT	はい	テナント ID
CALENDESK_GATEWAY_URL	いいえ	ゲートウェイ URL（デフォルトは https://mcp.calendesk.com）

開発

1. リポジトリをクローンします：

   git clone https://github.com/calendesk/calendesk-mcp-server.git
   cd calendesk-mcp-server
   

2. .env ファイルを作成します：

   cp .env.example .env
   # Edit .env with your CALENDESK_API_KEY and CALENDESK_TENANT
   

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

   pip install -e .
   

4. MCP Inspector を起動します（Node.js が必要です）：

   mcp dev calendesk_mcp/server.py:mcp
   

   インタラクティブにツールをテストできる Web UI が http://localhost:6274 に開きます。

プライバシーポリシー

Calendesk のプライバシーポリシー

サポート

MCP サーバーの統合に関するご質問や問題については、[email protected] までお問い合わせください。