Savvycal Mcp Server

SavvyCal MCP サーバー

Claude を SavvyCal アカウントに接続する MCP（Model Context Protocol）サーバーです。今後の会議について Claude に尋ねたり、空き状況を確認したり、会議を予約したり、スケジュールリンクを管理したりできます。すべて自然言語で操作できます。

できること

• 「今週はどんな会議がありますか？」 — 参加者の詳細と参加リンクを含む、今後の予約を一覧表示します
• 「来週、30 分の通話をする時間はありますか？」 — 任意のスケジュールリンクで空き時間枠を確認します
• 「火曜日の午後 2 時に [email protected] との会議を予約して」 — 直接予約を作成します
• 「今日の午後 3 時の会議をキャンセルして」 — 予定されているイベントをキャンセルします
• 「休暇中はイントロ通話のリンクを無効にして」 — スケジュールリンクを一時停止／再開します
• 「予約タイプをすべて表示して」 — ステータスと所要時間を含むすべてのスケジュールリンクを一覧表示します

ツール

ツール	説明
savvycal_list_events	日付フィルターとページネーションを使って、今後の会議と過去の会議を一覧表示します
savvycal_get_event	参加リンクを含む、特定のイベントの詳細を取得します
savvycal_cancel_event	予定されている会議をキャンセルします
savvycal_create_event	スケジュールリンクから会議を予約します
savvycal_list_scheduling_links	すべてのスケジュールリンクを一覧表示します
savvycal_get_available_slots	スケジュールリンクの空き時間枠を取得します
savvycal_toggle_link	スケジュールリンクを有効または無効にします
savvycal_get_current_user	アカウント情報とタイムゾーンを取得します

セットアップ

1. SavvyCal API キーを取得する

1. SavvyCal にログインします
2. Settings → Developer Settings に移動します
3. Create a token をクリックし、名前を付けます（例：「Claude MCP」）
4. トークンをコピーします。次の手順で使用します

2. Claude Code を設定する（stdio、ローカル利用）

プロジェクトのルートにある .mcp.json に追加します。

{
  "mcpServers": {
    "savvycal": {
      "command": "npx",
      "args": ["savvycal-mcp-server"],
      "env": {
        "SAVVYCAL_API_KEY": "pt_secret_your_token_here"
      }
    }
  }
}

または、次のコマンドを直接実行します。

SAVVYCAL_API_KEY=pt_secret_your_token_here npx savvycal-mcp-server

3. HTTP 用に設定する（リモート／ホスト型のデプロイ）

SAVVYCAL_API_KEY=pt_secret_your_token_here TRANSPORT=http PORT=3000 node dist/index.js

サーバーが公開するエンドポイント：

• POST /mcp — MCP エンドポイント
• GET /health — ヘルスチェック

開発

# Clone and install
git clone https://github.com/your-username/savvycal-mcp-server
cd savvycal-mcp-server
npm install

# Set your API key
export SAVVYCAL_API_KEY=pt_secret_your_token_here

# Build
npm run build

# Run (stdio)
npm start

# Run (HTTP)
TRANSPORT=http npm start

環境変数

変数	必須	デフォルト	説明
SAVVYCAL_API_KEY	✅ はい	—	SavvyCal の個人用アクセストークン
TRANSPORT	いいえ	stdio	トランスポートモード：stdio または http
PORT	いいえ	3000	HTTP トランスポート用のポート

会話の例

スケジュールの確認：

「明日はどんな会議がありますか？」 「今月の予約をすべて表示して」 「最近、誰かが会議をキャンセルしましたか？」

空き状況の確認：

「来週、30 分のイントロ通話をする時間はありますか？」 「金曜日にコンサルティング用リンクで空いている時間枠はありますか？」

会議の予約：

「来週月曜日の午前 10 時に、Sarah（[email protected]）との 30 分のイントロ通話を予約して」

リンクの管理：

「休暇に出るので、スケジュールリンクをすべて一時停止して」 「イントロ通話のリンクを再有効化して」 「有効なスケジュールリンクはいくつありますか？」

ライセンス

MIT