yarooms-mcp 1.0.0

package/.env.example

@@ -0,0 +1,2 @@
+YAROOMS_API_TOKEN=your-api-token-here
+YAROOMS_BASE_URL=https://your-tenant.yarooms.com/api

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YAROOMS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# YAROOMS MCP Server
+
+MCP server for the [YAROOMS](https://www.yarooms.com) 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
+
+```bash
+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)
+
+```bash
+npm run stdio
+```
+
+### Smithery Dev Mode
+
+```bash
+npm run dev
+```
+
+### Smithery Production
+
+```bash
+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
+
+```bash
+# Unit tests
+npm test
+
+# Integration tests (requires API credentials)
+RUN_INTEGRATION=true npm test
+```