Calendly

mcp-calendly

Calendly MCP パック — スケジューリングデータ用の Calendly API v2 ラッパーです。

Pipeworx の一部です。AI エージェントを 1875 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携機能であり、上流プロバイダーとの提携、承認、公開はありません。

ツール

ツール	説明
current_user	指定されたトークンの現在の Calendly ユーザーを取得します。ユーザー URI と組織 URI を返します。list_scheduled_events と list_event_types にはユーザー URI または組織 URI が必要なため、最初にこのツールを呼び出してください。
list_scheduled_events	予定されているミーティング（イベント）の一覧を取得します。ユーザー URI または組織 URI が必要です（current_user から取得してください）。ステータス、期間で絞り込み、ページネーションを利用できます。イベント URI／UUID、名前、開始／終了時刻、ステータス、場所を返します。
get_event	UUID を指定して、予定されているイベントを 1 件取得します（イベント URI の最後のパスセグメントです）。名前、時刻、ステータス、場所、イベントメンバーシップなど、イベントの詳細をすべて返します。
list_invitees	イベント UUID を指定して、予定されているイベントの招待者一覧を取得します。招待者の名前、メールアドレス、ステータス（有効／キャンセル済み）、タイムゾーン、予約時の質問への回答を返します。
list_event_types	予約可能なイベントタイプ（ミーティングテンプレート）の一覧を取得します。ユーザー URI または組織 URI が必要です（current_user から取得してください）。イベントタイプの URI、名前、所要時間、スケジューリング URL、有効状態を返します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "calendly": {
      "url": "https://gateway.pipeworx.io/calendly/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/calendly/mcp の tools/list は、上の表にあるツールに加えて、共通の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに共通ツールが約 30 個表示されます。接続の initialize レスポンスに正確な対象範囲が記載されており、その日の状況を確認する際の確定情報となります。

これは意図的なものであり、偶発的に多重化されているわけではありません。メタツールを使えば、このパックがカバーしていない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できます。そのため、MCP サーバーを 2 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利便性を上回る場合は、複数のパックエンドポイントではなく、完全なゲートウェイに 1 度接続してください。

また、Pipeworx の完全なゲートウェイに接続すると、このパックだけでなく、各パックのすべてのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと、同じ 1875 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使えばすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

このパックでは、ご自身の API キー（_apiKey）を使用します。こちらでは API キーを用意していないため、キーなしで実行できる curl コマンドはありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/calendly_current_user を使います。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使います。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントやゲートウェイへの往復通信は必要ありません。

{
  "mcpServers": {
    "calendly": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-calendly"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-calendly

stdin/stdout 経由で MCP 通信を行い、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共通メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、完全なゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Calendly data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT