Resource Rooms
Manage room resources with capacity settings for appointment bookings. Assign rooms to calendar events and track room availability across locations.
Physical space is a finite resource. A clinic has treatment rooms. A training center has classrooms. A coworking space has meeting rooms. Resource Rooms lets you manage these spaces within the calendar system so room availability is factored into booking decisions, preventing double-bookings of physical locations.
What This MCP Tool Does
CRUD operations on room resources. Create rooms with capacity settings, list all rooms, update room configurations, and delete rooms. Rooms can be assigned to calendars so booking availability reflects both team member availability and room availability.
Endpoint Reference
List rooms: GET /calendars/resources/rooms
Create a room: POST /calendars/resources/rooms
Update a room: PUT /calendars/resources/rooms/{roomId}
Delete a room: DELETE /calendars/resources/rooms/{roomId}
Authentication
Requires a Private Integration Token (PIT) with the calendars scope enabled.
Key Parameters
name— room namecapacity— maximum occupancydescription— room details (location within building, equipment available)calendarIds— calendars this room is associated with
Important Notes
Room availability works the same way as equipment. When a room is fully booked for a time slot, calendars requiring that room show no availability for that period.
Capacity settings matter for class-type bookings where multiple attendees book into the same slot. A room with capacity 20 and a class calendar allowing 20 bookings per slot will correctly limit bookings.
Common Questions
Can a room be assigned to multiple calendars? Yes. A meeting room might be used by both the sales team’s consultation calendar and the support team’s onboarding calendar.
Does room capacity affect individual appointment bookings? For one-on-one appointment calendars, capacity is typically 1 (one appointment per room per slot). For class bookings, capacity determines how many attendees can book into the same slot.
Related MCP Tools
- Resource Equipment — Equipment resource management (similar pattern)
- Calendar CRUD — Calendars that use room resources
- Free Slots — Room availability affects slot calculations
- Appointment CRUD — Bookings that reserve rooms
- Calendar Groups — Group calendars sharing rooms