Astrocal

@astrocal/mcp-server

AI エージェントに会議をスケジュールする力を与えましょう。 Astrocal の公式 Model Context Protocol サーバーです。開発者と AI エージェント向けに構築された、API ファーストのスケジューリングプラットフォームです。

Claude Desktop、Cursor、Windsurf、および MCP 互換のあらゆるクライアントで動作します。AI アシスタントは、自然な会話を通じて空き状況の確認、会議の予約、キャンセル、再スケジュール、待機リストの管理を行えます。

API キーを取得 | ドキュメント | API リファレンス

AI エージェントに Astrocal を選ぶ理由

• AI 向けに特化して構築 — Calendly の後付け機能ではありません。Astrocal のスケジューリング APIは、初日からプログラムによるアクセスと AI エージェントからのアクセスを想定して設計されています。
• 8 つのツール、設定不要 — 空き状況の確認、予約、キャンセル、再スケジュール、イベントタイプの一覧表示、待機リストの管理に対応しています。エージェントに必要な機能がすべてそろっています。
• カレンダー同期を内蔵 — Google Calendar、Microsoft 365、CalDAV に接続できます。エージェントは実際の空き状況に基づいて予約します。
• 決済機能を内蔵 — Stripe Connect との連携により、エージェントは無料の会議だけでなく、有料のコンサルティングも予約できます。
• サンドボックスモード — ac_test_* キーを使ってテストできます。メールは送信されず、カレンダーイベントも作成されず、請求も発生しません。

クイックスタート

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "astrocal": {
      "command": "npx",
      "args": ["-y", "@astrocal/mcp-server"],
      "env": {
        "ASTROCAL_API_KEY": "ac_live_xxxxxxxxxxxxx"
      }
    }
  }
}

Claude Desktop を再起動すると、スケジューリングツールをすぐに利用できます。

その他の MCP クライアント

グローバルにインストールします。

npm install -g @astrocal/mcp-server

実行します。

ASTROCAL_API_KEY=ac_live_xxx astrocal-mcp

環境変数

変数	必須	説明
ASTROCAL_API_KEY	はい	Astrocal API キー（無料で取得）
ASTROCAL_API_URL	いいえ	API のベース URL（デフォルト：https://api.astrocal.dev）
ASTROCAL_DEFAULT_EVENT_TYPE_ID	いいえ	デフォルトのイベントタイプ ID — エージェントは呼び出しごとに指定する必要がありません

利用可能なツール

check_availability

予約可能な時間枠を確認します。

• event_type_id（string、任意） — 確認するイベントタイプです。ASTROCAL_DEFAULT_EVENT_TYPE_ID が設定されている場合は省略できます。
• start_date（string、必須） — ISO 8601 形式の開始日（例：2026-03-15）
• end_date（string、必須） — ISO 8601 形式の終了日（例：2026-03-22）
• timezone（string、任意） — IANA タイムゾーン（例：America/New_York）。デフォルトは UTC です。

create_booking

指定した時間に会議を予約します。

• event_type_id（string、任意） — 予約するイベントタイプです。デフォルトが設定されている場合は省略できます。
• start_time（string、必須） — ISO 8601 形式の日時（例：2026-03-15T14:00:00Z）
• invitee_name（string、必須） — 予約する人の氏名
• invitee_email（string、必須） — カレンダーへの招待状の送信先メールアドレス
• invitee_timezone（string、任意） — IANA タイムゾーンです。デフォルトは UTC です。
• notes（string、任意） — 会議メモ（最大 1000 文字）

cancel_booking

既存の予約をキャンセルします。予約者には自動的にキャンセルメールが送信されます。

• booking_id（string、必須） — キャンセルする予約の ID
• reason（string、任意） — キャンセル理由（最大 500 文字）

reschedule_booking

予約の日時を変更します。最初に空き状況を確認してください。

• booking_id（string、必須） — 日時を変更する予約の ID
• new_start_time（string、必須） — ISO 8601 形式の新しい日時
• reason（string、任意） — 日時変更の理由（最大 500 文字）

list_bookings

任意のフィルターを指定して予約を一覧表示します。

• status（文字列、任意）— フィルター：confirmed、cancelled、または pending_payment
• limit（数値、任意）— 最大結果数（デフォルト：10、最大：100）
• event_type_id（文字列、任意）— イベントタイプでフィルターします

list_event_types

予約可能なイベントタイプを一覧表示します。入力は不要です。

join_waitlist

すべての枠が埋まっている場合に、ウェイトリストに登録します。

• event_type_id（文字列、必須）— ウェイトリストへの登録対象となるイベントタイプ
• name（文字列、必須）— 氏名
• email（文字列、必須）— メールアドレス
• preferred_times（文字列、任意）— 希望する時間帯または備考

check_waitlist

ウェイトリストでの順番を確認します。

• waitlist_entry_id（文字列、必須）— join_waitlist から返されたウェイトリスト登録 ID

会話の例

ユーザー：「予約できるミーティングはありますか？」

エージェント： list_event_types を呼び出します — 「イベントタイプは2つあります。30分の相談（無料）と、1時間の戦略セッション（$50）です。」

ユーザー：「来週火曜日の午後2時に、相談の空きがあるか確認してください」

エージェント： check_availability を呼び出します — 「火曜日の午後2時は空いています。」

ユーザー：「[email protected] 宛てに予約してください」

エージェント： create_booking を呼び出します — 「完了しました！Jane とのミーティングは3月17日火曜日の午後2時（UTC）に確定しました。カレンダーへの招待を送信しました。」

ユーザー：「やっぱり午後3時に変更してください」

エージェント： reschedule_booking を呼び出します — 「午後3時に変更しました。Jane に通知しました。」

Astrocal プラットフォームの一部

この MCP サーバーは、Astrocal と連携する複数の方法の1つです。

• REST API — OpenAPI 3.1 仕様に対応した、スケジューリング用の完全な API
• React SDK（@astrocal/react）— React アプリ向けの型付きフック、プロバイダー、予約ウィジェット
• 埋め込み可能なウィジェット（@astrocal/widget）— あらゆるウェブサイトに追加できる予約 UI
• ダッシュボード — イベントタイプ、予約、チームメンバー、請求を管理します
• Webhook — 予約イベントのリアルタイム通知

無料アカウントを作成して、利用を開始しましょう。

リンク

• Astrocal ウェブサイト
• ドキュメント
• API リファレンス
• ダッシュボード
• GitHub
• 問題の報告

ライセンス

MIT