Demo MCP Server

A Model Context Protocol (MCP) server providing math operations and OnceHub booking calendar integration.

Features

🧮 Math Tools

• add: Add two numbers together with input validation

📅 Booking Tools

• get_booking_time_slots: Retrieve all available time slots from OnceHub booking calendars
• schedule_meeting: Book meetings with participant details and location preferences

Installation

pip install demo-mcp-server

Or with uv:

uv add demo-mcp-server

Configuration

API Key Setup

The OnceHub API key is configured once during integration:

For Claude Desktop:

{
  "mcpServers": {
    "demo-mcp-server": {
      "command": "demo-mcp-server",
      "env": {
        "ONCEHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

For Command Line:

# Set environment variable
export ONCEHUB_API_KEY="your_api_key_here"

# Run server
demo-mcp-server

For Windows:

set ONCEHUB_API_KEY=your_api_key_here
demo-mcp-server

Usage

Once configured, you can use the tools without specifying the API key:

# Get available slots
"Get booking slots for calendar 'cal_123'"

# Schedule meeting  
"Schedule a meeting for calendar 'cal_123' on 2024-01-15 at 2:30 PM EST for John Doe (john@example.com)"

Development

git clone https://github.com/yourusername/demo-mcp-server.git
cd demo-mcp-server
uv sync

License

MIT License - see LICENSE file for details.