When2Meet MCP Server

When2Meet MCP 服务

一款由 AI 驱动的日程安排助手，通过 Model Context Protocol（MCP）自动填写 When2Meet 的可用时间。这款工具可帮助用户提取活动详情、选择时间段，并在 When2Meet 日程投票中自动标记可用时间。

功能

• 🔍 提取活动详情：自动抓取并解析 When2Meet 活动
• 🗣️ 智能时间选择：使用自然语言、代码或直接时间戳选择时间段
• 🤖 自动标记可用时间：无需手动点击即可标记可用时间
• 🔌 MCP 集成：连接到任何支持 Model Context Protocol 的 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

支持的工具

1. get-event-details

从任意 When2Meet URL 中提取信息。

// Example response
{
  "name": "Team Meeting",
  "dateRange": "April 7-9, 2025",
  "availableTimeslots": {
    // Structured time slot data with timestamps
  }
}

2. generate-availability-prompt

创建包含所有可选时间段的结构化选择提示词。

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

3. parse-availability-selections

使用多种输入格式将选择项转换为实际时间戳：

• 时间段代码（d0t0 d1t2）
• 时间模式（morning0 day1）
• 直接时间戳（1744549200, 1744550100）

4. mark-when2meet-availability

使用浏览器自动化，在 When2Meet 上自动标记可用时间。

客户端使用示例

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

// Create client transport
const transport = new StdioClientTransport({
  command: "node",
  args: ["when2meet-server.js"]
});

// Initialize client
const client = new Client(
  { name: "when2meet-client", version: "1.0.0" },
  { capabilities: { prompts: {}, resources: {}, tools: {} } }
);

// Connect and use tools
await client.connect(transport);

// Get event details
const eventDetails = await client.callTool({
  name: "get-event-details",
  arguments: { eventUrl: "https://www.when2meet.com/your-event-id" }
});

// Mark availability
await client.callTool({
  name: "mark-when2meet-availability", 
  arguments: {
    eventUrl: "https://www.when2meet.com/your-event-id",
    userName: "Your Name",
    timestamps: [1744549200, 1744550100]
  }
});

使用场景

• AI 助手集成：让 AI 助手代你处理日程安排
• 自动安排日程：无需手动操作即可安排会议
• 自然语言安排日程：用通俗英语表达可用时间
• 批量标记可用时间：一次标记多个时间段

要求

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

许可证

MIT

即将推出的集成

• 支持直接通过 Google Calendar 安排日程