YAROOMS MCP Server

MCP server for the YAROOMS workplace management platform. Enables AI agents (Claude, ChatGPT, Copilot, etc.) to search rooms, book spaces, manage visitors, and set work status through the Model Context Protocol.

Setup

npm install

Environment Variables

Create a .env file (see .env.example):

YAROOMS_API_TOKEN=your-api-token
YAROOMS_BASE_URL=https://your-tenant.yarooms.com/api

Usage

Local (stdio)

npm run stdio

Smithery Dev Mode

npm run dev

Smithery Production

npm run build
npm start

Tools

| Tool | Description | |------|-------------| | search_available_spaces | Search for available rooms/desks on a floor | | create_booking | Book a room or desk | | get_my_bookings | View your bookings | | cancel_booking | Cancel a booking | | modify_booking | Change booking time, space, or title | | check_in_booking | Check in to a booking | | check_out_booking | Check out of a booking | | get_locations | List office locations | | get_floors | List floors for a location | | get_floor_info | Get floor details and spaces | | get_room_schedule | View room booking timeline | | get_space_types | List space types (Desk, Meeting Room, etc.) | | get_location_schedule | Get operating hours for a location | | get_booking_options | Get valid booking intervals for a space (resolves booking strategy) | | get_work_status | View work status (WFH, office, etc.) | | set_work_status | Set work status for dates | | register_visitor | Register a visitor | | list_visitors | List visitors for a date/location | | cancel_visitor | Cancel a visitor registration | | get_all_bookings | List all bookings (admin) — filter by date, location, space, booker, title, status | | get_pending_approvals | List booking requests pending your approval | | approve_booking | Approve pending booking requests | | reject_booking | Reject pending booking requests with optional reason | | search_people | Search for people by name or email | | get_my_profile | Get your profile — name, email, team, location | | get_teammates | List members of your team | | get_teammate_status | View a teammate's work status | | get_teammate_bookings | View a teammate's bookings for a date |

Resources

| Resource | URI | Description | |----------|-----|-------------| | Work Status Options | yarooms://work-status-options | Available status options with IDs |

Testing

# Unit tests
npm test

# Integration tests (requires API credentials)
RUN_INTEGRATION=true npm test