Install the Yoya MCP

Yoya speaks the Model Context Protocol, so you can drive it from your AI agent — Claude Code, Cursor, Claude Desktop, Windsurf, and other MCP clients. Your agent sets up and manages your booking page, and any agent can find one of your times and book it.

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, Claude Desktop & other clients

For clients configured with a JSON file, 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"]
    }
  }
}

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 disconnect any time by removing the server in your client, and revoke access from your Yoya dashboard.

Support

Questions? Email leo@yoya.ai.