MCP Integration

QuandoPosso provides two MCP (Model Context Protocol) servers that allow AI assistants like Claude Desktop, Cursor, and other MCP clients to interact with the platform without opening a browser.

Available servers

Booking MCP (public)

Check availability and book meetings with any QuandoPosso user. No authentication required.

URL: https://booking-mcp.quandoposso.com/mcp

Tools:

get_availability — Check a host’s available time slots (by username, date, and duration). Accepts an optional slug parameter to check availability for a specific scheduling link (defaults to the host’s default link). Returns accessRestricted: true if the link has access restrictions.
book_slot — Book a meeting at an available time slot. Accepts an optional slug parameter to book on a specific scheduling link (defaults to the host’s default link). If the link has access restrictions, the guest’s email must be on the allowed list.

Config MCP (authenticated)

Read and update your scheduling settings. Requires Google login on first connection.

URL: https://config-mcp.quandoposso.com/mcp

Tools:

whoami — Verify the connection and return your account info.
get_settings — Return all scheduling settings.
update_working_hours — Change your working days and hours.
update_slot_duration — Set available meeting durations.
update_buffer — Change the pre-meeting and post-meeting buffer times. Accepts preMeetingBuffer (0-120 minutes) and postMeetingBuffer (0-120 minutes). Buffers create protection zones around existing calendar events, not between available slots.
update_booking_rules — Change minimum notice, booking window, meeting name, Meet link, and guest invite settings.
list_calendar_accounts — List connected Google Calendar accounts and their selections.
list_availability_overrides — List one-off availability overrides. Accepts optional from and to date filters (YYYY-MM-DD).
create_availability_override — Create a one-off availability window. Parameters: date, startTime, endTime, ignoreBusy (optional, defaults to true), linkIds (optional, array of scheduling link IDs), label (optional).
delete_availability_override — Delete an availability override by ID.
list_scheduling_links — List all your scheduling links with their slugs and settings.
create_scheduling_link — Create a new named scheduling link (requires a slug and name). Supports allowedBookers for access restrictions.
update_scheduling_link — Update settings for a specific scheduling link (by slug). Supports allowedBookers for access restrictions.

How to connect

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "quandoposso-booking": {
      "command": "npx",
      "args": ["mcp-remote", "https://booking-mcp.quandoposso.com/mcp"]
    },
    "quandoposso-config": {
      "command": "npx",
      "args": ["mcp-remote", "https://config-mcp.quandoposso.com/mcp"]
    }
  }
}

Restart Claude Desktop. The first time you use the Config MCP, your browser will open for Google login.

Cursor / Windsurf

Use the same configuration above in your editor’s MCP config file.

Other MCP clients

Any MCP-compatible client can connect using the URLs above. The Booking MCP accepts direct connections. The Config MCP uses OAuth 2.1 with dynamic client registration — the authentication flow is automatic.

Usage examples

After connecting, ask your AI assistant:

“What are rafael’s available times for tomorrow?”
“What are rafael’s available times for a quick-chat tomorrow?” (checks the quick-chat link)
“Book a 30-minute meeting with rafael tomorrow at 2pm”
“Book a quick-chat with rafael tomorrow at 2pm” (books on the quick-chat link)
“Show my scheduling settings”
“List all my scheduling links”
“Create a new scheduling link called ‘Quick Chat’ with slug ‘quick-chat’”
“Update my quick-chat link to have 15-minute slots”
“Set my pre-meeting buffer to 15 minutes and post-meeting buffer to 10 minutes”
“Set my working hours to Monday through Friday, 9am to 6pm”

Requirements

Node.js 18+ (for npx mcp-remote)
A QuandoPosso account (for the Config MCP)