When2meet MCP

🚀 When2Meet MCP Server

An AI-based scheduling assistant that automates When2Meet availability marking through the Model Context Protocol (MCP). This tool helps users extract event details, select time slots, and automatically mark availability in When2Meet scheduling polls.

🚀 Quick Start

📦 Installation

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

Run the MCP Server

node when2meet-server.js

Test the MCP Client

node client.js

✨ Features

• 🔍 Extract Event Details: Automatically fetch and parse When2Meet events.
• 🗣️ Intelligent Time Selection: Select time slots using natural language, code, or direct timestamps.
• 🤖 Automated Availability Marking: Mark your availability without manual clicks.
• 🔌 MCP Integration: Connect with any AI assistant supporting the Model Context Protocol.

💻 Usage Examples

Basic Usage

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 the 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]
  }
});

📚 Documentation

Supported Tools

1. get-event-details

Extract information from any When2Meet URL.

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

2. generate-availability-prompt

Create a structured selection prompt containing all available time slots.

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

3. parse-availability-selections

Convert selections into actual timestamps, supporting multiple input formats:

• Time slot codes (d0t0 d1t2)
• Time patterns (morning0 day1)
• Direct timestamps (1744549200, 1744550100)

4. mark-when2meet-availability

Automatically mark your availability on When2Meet using browser automation.

Use Cases

• AI Assistant Integration: Let AI assistants handle scheduling for you.
• Automated Scheduling: Schedule meetings without manual intervention.
• Natural Language Scheduling: Express availability using plain English.
• Batch Availability Marking: Mark multiple time slots at once.

Requirements

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

📄 License

MIT

Upcoming Integrations

• Support for direct Google Calendar scheduling