When2meet MCP

🚀 When2Meet MCP サーバー

人工知能に基づくスケジューリングアシスタントで、モデルコンテキストプロトコル（MCP）を通じてWhen2Meetの可用性を自動的にマークします。このツールは、ユーザーがイベントの詳細を抽出し、タイムスロットを選択し、When2Meetの投票で自動的に可用性をマークするのを支援します。

✨ 主な機能

• 🔍 イベント詳細の抽出：When2Meetのイベントを自動的に取得して解析します。
• 🗣️ スマートな時間選択：自然言語、コード、または直接のタイムスタンプを使用してタイムスロットを選択できます。
• 🤖 自動可用性マーキング：手動でクリックすることなく、あなたの可用性をマークします。
• 🔌 MCP 統合：モデルコンテキストプロトコルをサポートする任意のAIアシスタントと接続できます。

🚀 クイックスタート

📦 インストール

git clone https://github.com/joyce-yuan/when2meet-mcp.git
cd when2meet-mcp
npm install

MCP サーバーの実行

node when2meet-server.js

MCP クライアントのテスト実行

node client.js

💻 使用例

基本的な使用法

const { Client } = require("@modelcontextprotocol/sdk/client/index.js");
const { StdioClientTransport } = require("@modelcontextprotocol/sdk/client/stdio.js");

// クライアントトランスポートを作成
const transport = new StdioClientTransport({
  command: "node",
  args: ["when2meet-server.js"]
});

// クライアントを初期化
const client = new Client(
  { name: "when2meet-client", version: "1.0.0" },
  { capabilities: { prompts: {}, resources: {}, tools: {} } }
);

// 接続してツールを使用
await client.connect(transport);

// イベント詳細を取得
const eventDetails = await client.callTool({
  name: "get-event-details",
  arguments: { eventUrl: "https://www.when2meet.com/your-event-id" }
});

// 可用性をマーク
await client.callTool({
  name: "mark-when2meet-availability", 
  arguments: {
    eventUrl: "https://www.when2meet.com/your-event-id",
    userName: "あなたの名前",
    timestamps: [1744549200, 1744550100]
  }
});

📚 ドキュメント

サポートツール

1. get-event-details

任意のWhen2Meet URLから情報を抽出します。

// サンプルレスポンス
{
  "name": "チーム会議",
  "dateRange": "2025年4月7日から9日まで",
  "availableTimeslots": {
    // タイムスタンプを含む構造化されたタイムスロットデータ
  }
}

2. generate-availability-prompt

すべての利用可能なタイムスロットを含む構造化された選択プロンプトを作成します。

[d0t0] 午前9:00 (1744549200)
[d0t1] 午前9:15 (1744550100)

3. parse-availability-selections

選択を実際のタイムスタンプに変換し、複数の入力形式をサポートします。

• タイムスロットコード（d0t0 d1t2）
• 時間パターン（morning0 day1）
• 直接のタイムスタンプ（1744549200, 1744550100）

4. mark-when2meet-availability

ブラウザ自動化を使用して、When2Meetで自動的にあなたの可用性をマークします。

使用シナリオ

• AIアシスタント統合：AIアシスタントにスケジューリングを任せます。
• 自動スケジューリング：手動介入なしで会議をスケジュールします。
• 自然言語によるスケジューリング：plain Englishで可用性を表現できます。
• 一括可用性マーキング：一度に複数のタイムスロットをマークできます。

要件

• Node.js 18+
• @modelcontextprotocol/sdk (^1.8.0)
• puppeteer
• zod

📄 ライセンス

MIT

近日実装予定の統合

• Googleカレンダーへの直接スケジューリングのサポート