# YAROOMS

Connect your AI agent to YAROOMS, the workplace management platform for hybrid teams. Search for available rooms and desks, create and manage bookings, set your work status (office, WFH, traveling), …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add yarooms/yarooms-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list yarooms/yarooms-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get yarooms/yarooms-mcp search_available_spaces

# Call a tool
npx -y @smithery/cli@latest tool call yarooms/yarooms-mcp search_available_spaces '{}'
```

## Direct MCP Connection

Endpoint: `https://yarooms-mcp--yarooms.run.tools`

**Optional config:**
- `YAROOMS_BASE_URL` (query) — If set, uses API key auth for this URL instead of OAuth; pair with YAROOMS_API_TOKEN.
- `YAROOMS_API_TOKEN` (query) — Obtained from the Integrations section in YAROOMS

## Tools (28)

- `search_available_spaces` — Search for available rooms and desks on a specific floor and date. Returns space names, types, capacity, and availabili…
- `create_booking` — Book a room or desk. Use search_available_spaces first to find available space IDs.
- `get_my_bookings` — View your bookings. Optionally filter by date.
- `cancel_booking` — Cancel a booking by ID.
- `modify_booking` — Modify an existing booking (change time, space, or title). Fetches current booking first, then applies changes.
- `check_in_booking` — Check in to a booking.
- `check_out_booking` — Check out of a booking.
- `get_all_bookings` — List all bookings across the organization (admin). Filter by date, location, space, booker, title, status, and more. Re…
- `get_locations` — List all office locations. Optionally filter by name.
- `get_floors` — List floors for a location. Use get_locations first to find location IDs, then this to discover floor IDs.
- `get_floor_info` — Get floor details and list of spaces (rooms, desks) on that floor. Use get_floors to discover floor IDs first.
- `get_room_schedule` — View the booking timeline for all rooms on a floor for a given date. Shows who booked what and when.
- `get_space_types` — List available space types (Desk, Meeting Room, Parking, etc.) with their IDs. Use space_type_id to filter in search_av…
- `get_location_schedule` — Get the operating hours for a location. Returns the schedule for each day of the week (day_id: 1=Sunday, 2=Monday, ...,…
- `get_booking_options` — Get the valid booking intervals for a specific space on a given date. This resolves the space's booking strategy (full_…
- `get_work_status` — View work status (WFH, office, etc.) for a user over a date range.
- `set_work_status` — Set your work status for one or more dates. Use the yarooms://work-status-options resource to find valid status IDs.
- `register_visitor` — Register a visitor for a specific date and location.
- `list_visitors` — List visitors for a specific date and location.
- `cancel_visitor` — Cancel a visitor registration by visit ID. Use list_visitors to find visit IDs.
- `search_people` — Search for people by name or email. Returns account IDs you can use with get_all_bookings, get_teammate_status, or get_…
- `get_my_profile` — Get your YAROOMS profile — name, email, team, location, and account ID.
- `get_teammates` — List members of your team. Returns names, emails, and account IDs that you can use with get_teammate_status and get_tea…
- `get_teammate_status` — View a teammate's work status (WFH, office, etc.) for a date range. Use get_teammates first to find their account ID.
- `get_teammate_bookings` — View a teammate's bookings for a specific date. Use get_teammates first to find their account ID.
- `get_pending_approvals` — List booking requests pending your approval. Returns approval details including booker, space, dates, and the changes r…
- `approve_booking` — Approve one or more pending booking requests. Use get_pending_approvals first to see what needs approval.
- `reject_booking` — Reject one or more pending booking requests with an optional reason. Use get_pending_approvals first to see what needs …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get yarooms/yarooms-mcp <tool-name>
```

## Resources

- `yarooms://work-status-options` — Available work status options (e.g., In Office, WFH, Away) with their IDs. Use these IDs with the set_work_status tool.