OnceHub MCP Server

What is OnceHub MCP Server?

The OnceHub MCP Server is a remote MCP server that enables AI agents to interact with the OnceHub scheduling API via natural language, retrieving availability and scheduling meetings on behalf of users. It is compatible with VS Code Copilot, OpenAI, and any MCP-compatible AI client.

How to use OnceHub MCP Server?

Obtain an OnceHub API key, then configure your MCP-compatible client (e.g., VS Code, Claude Desktop) with the server URL https://mcp.oncehub.com/sse and the API key as a Bearer token. Ask the AI assistant to “show me available time slots for calendar BKC-XXXXXXXXXX” or “schedule a meeting for tomorrow at 2 PM with John Doe.” Alternatively, run the server locally using uv run main.py or via Docker.

Key features of OnceHub MCP Server

• MCP Protocol support for any compatible AI client.
• Retrieves available booking time slots from OnceHub calendars.
• Schedules meetings with guest information automatically.
• API key-based authentication via headers.
• Well tested with 92% code coverage.
• Docker support for easy containerized deployment.

Use cases of OnceHub MCP Server

• AI assistant retrieves available time slots from a OnceHub booking calendar.
• AI assistant schedules a meeting on behalf of a user with guest details.
• Integrate OnceHub scheduling into AI-driven workflows without manual link sharing.
• Automate meeting booking via natural language in VS Code Copilot or ChatGPT.

FAQ from OnceHub MCP Server

What is the OnceHub MCP Server and how does it differ from the OnceHub API?

The OnceHub MCP Server wraps the OnceHub scheduling API under the Model Context Protocol, allowing AI agents to use natural language commands instead of raw API calls, making it easier to integrate into AI-driven workflows.

What are the runtime requirements?

Python 3.13 or higher, the uv package manager (recommended), and a valid OnceHub API key. The API endpoint URL defaults to https://api.oncehub.com.

Is the server hosted or can I run it myself?

A hosted production server is available at https://mcp.oncehub.com/sse. You can also run the server locally using uv or Docker, following the installation instructions in the README.

What authentication does the server use?

Authentication is API key-based, passed as a Bearer token in the Authorization header of HTTP requests from the MCP client.

What transport protocol is used?

The server communicates over HTTP with Server-Sent Events (SSE). The MCP endpoint is /sse.