Connect Yoya to your AI assistant

Yoya speaks the Model Context Protocol, so you can manage it from a compatible AI assistant, such as Claude Code, Cursor, Claude Desktop, Windsurf, and other MCP clients. Your agent sets up and manages your booking page. Guests can also use a compatible assistant to find an available time and book a meeting. Your plan’s booking limits still apply.

Step-by-step guides: Claude Code and Cursor. Both include a read-only connection check and the details to confirm before booking.

Two servers

• Manage your Yoya — https://yoya.ai/api/mcp. Sign in with your Yoya account when your client prompts you. Tools: create or update your booking page, set your weekly hours and date overrides, list your bookings, get your share link, and check your Google Calendar / Zoom connection.
• Find & book (public, no sign-in) — https://yoya.ai/api/mcp/book. Tools: look up a booking page by its link, list its open times, book a meeting, and check a booking. This is the side another person's agent uses to book with you.

Claude Code

Add either server from the terminal:

# Manage your Yoya (opens a browser to sign in)
claude mcp add --transport http yoya https://yoya.ai/api/mcp

# Find & book on Yoya pages (no sign-in)
claude mcp add --transport http yoya-book https://yoya.ai/api/mcp/book

Cursor and other remote MCP clients

For Cursor, merge these entries into your MCP configuration to add Yoya as a remote (Streamable HTTP) server:

{
  "mcpServers": {
    "yoya": {
      "url": "https://yoya.ai/api/mcp"
    },
    "yoya-book": {
      "url": "https://yoya.ai/api/mcp/book"
    }
  }
}

Some desktop clients don't yet speak remote MCP directly — in that case bridge with mcp-remote:

{
  "mcpServers": {
    "yoya": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://yoya.ai/api/mcp"]
    }
  }
}

Time zones and booking confirmation

The web booking page displays the guest’s detected or selected time zone. The public MCP server returns available time labels in the host’s time zone; ask your assistant to convert them and show the full date. Confirm the slot, guest email, and meeting option before booking. If calendar updates or notifications are pending, use the returned management link to check their status.

Signing in

The manage server uses OAuth: the first time your agent calls a tool, your client opens a browser to sign in to Yoya and authorize access — then it acts as you. The find & book server needs no sign-in. You can stop using either server by removing it from your AI client’s settings. Removing a server from a client does not revoke previously granted authorization.

Support

Questions? Email leo@yoya.ai.