| name | ioffice-mcp |
| description | Access iOffice workspace and facility data via MCP. Use when the user asks about iOffice buildings, floors, spaces, reservations, visitors, maintenance requests, moves, or mail. Triggers on phrases like "book a room in iOffice", "check who's visiting today", "file a maintenance request", "log a package", "schedule a move", or any request involving workplace management in iOffice. Requires ioffice-mcp installed and the ioffice server registered (see Setup below). |
ioffice-mcp
MCP server for iOffice — natural-language workspace and facility management via the iOffice API.
Setup
Option A — npx (recommended)
Add to .mcp.json in your project or ~/.claude/mcp.json:
{
"mcpServers": {
"ioffice": {
"command": "npx",
"args": ["-y", "ioffice-mcp"],
"env": {
"IOFFICE_HOST": "your-tenant.ioffice.com",
"IOFFICE_TOKEN": "your-token-here"
}
}
}
}
Option B — from source
git clone https://github.com/chrischall/ioffice-mcp
cd ioffice-mcp
npm install && npm run build
Then add to .mcp.json:
{
"mcpServers": {
"ioffice": {
"command": "node",
"args": ["/path/to/ioffice-mcp/dist/index.js"],
"env": {
"IOFFICE_HOST": "your-tenant.ioffice.com",
"IOFFICE_TOKEN": "your-token-here"
}
}
}
}
Or use a .env file in the project directory with IOFFICE_HOST and IOFFICE_TOKEN.
Authentication
Token auth (preferred) — set IOFFICE_TOKEN. Alternatively, set IOFFICE_USERNAME + IOFFICE_PASSWORD. If both are present, the token takes precedence.
Tools
Buildings
| Tool | Description |
|---|
io_list_buildings | List buildings with optional search, pagination, and sorting |
io_get_building(id) | Get a single building by ID |
io_create_building(name, address1?, city?, ...) | Create a new building |
io_update_building(id, ...) | Update a building — only provide fields to change |
io_delete_building(id) | Delete a building |
Floors
| Tool | Description |
|---|
io_list_floors(buildingId?) | List floors, optionally filtered by building |
io_get_floor(id) | Get a single floor by ID |
io_create_floor(name, buildingId, ...) | Create a floor within a building |
io_update_floor(id, ...) | Update a floor |
io_delete_floor(id) | Delete a floor |
Spaces
| Tool | Description |
|---|
io_list_spaces(floorId?) | List spaces/rooms, optionally filtered by floor |
io_get_space(id) | Get a single space by ID |
io_create_space(name, floorId, capacity?, ...) | Create a space on a floor |
io_update_space(id, ...) | Update a space |
io_delete_space(id) | Delete a space |
Users
| Tool | Description |
|---|
io_list_users(search?) | List users with optional search |
io_get_user(id) | Get a single user by ID |
io_create_user(firstName, lastName, email, ...) | Create a new user |
io_update_user(id, ...) | Update a user |
io_delete_user(id) | Delete a user |
Reservations
| Tool | Description |
|---|
io_list_reservations(spaceId?, userId?, startDate?, endDate?) | List reservations with optional filters |
io_get_reservation(id) | Get a single reservation by ID |
io_create_reservation(title, spaceId, startDate, endDate, ...) | Reserve a space |
io_update_reservation(id, ...) | Update a reservation |
io_delete_reservation(id) | Cancel/delete a reservation |
io_checkin_reservation(id) | Check in to a reservation, confirming room usage |
io_checkout_reservation(id) | Check out early, releasing the room |
Visitors
| Tool | Description |
|---|
io_list_visitors(buildingId?, startDate?, endDate?) | List visitors with optional filters |
io_get_visitor(id) | Get a single visitor record by ID |
io_create_visitor(firstName, lastName, hostId?, expectedArrival?, ...) | Pre-register a visitor |
io_update_visitor(id, ...) | Update a visitor record |
io_checkin_visitor(id) | Check in a visitor upon arrival |
io_checkout_visitor(id) | Check out a visitor upon departure |
Maintenance Requests
| Tool | Description |
|---|
io_list_maintenance_requests(status?, spaceId?, buildingId?) | List maintenance requests |
io_get_maintenance_request(id) | Get a single maintenance request |
io_create_maintenance_request(title, spaceId?, buildingId?, ...) | File a new maintenance request |
io_update_maintenance_request(id, ...) | Update a maintenance request |
io_accept_maintenance_request(id) | Accept a pending request (pending → accepted) |
io_start_maintenance_request(id) | Start work (accepted → in-progress) |
io_complete_maintenance_request(id, resolution?) | Mark as complete |
io_archive_maintenance_request(id) | Archive a completed request |
Moves
| Tool | Description |
|---|
io_list_moves(status?, buildingId?) | List move requests |
io_get_move(id) | Get a single move request |
io_create_move(name, fromSpaceId?, toSpaceId?, scheduledDate?, ...) | Create a move request |
io_update_move(id, ...) | Update a move request |
io_approve_move(id, notes?) | Approve a move request |
io_cancel_move(id, reason?) | Cancel a move request |
Mail
| Tool | Description |
|---|
io_list_mail(status?, recipientId?, buildingId?) | List mail items (packages and letters) |
io_get_mail(id) | Get a single mail item |
io_create_mail(recipientId, buildingId, carrier?, trackingNumber?, ...) | Log a received mail item |
io_deliver_mail(id, deliveredDate?, signature?) | Mark a mail item as delivered |
io_return_mail(id, reason?) | Mark a mail item as returned to sender |
Workflows
Book a meeting room:
io_list_buildings → find building ID
io_list_floors(buildingId) → find floor ID
io_list_spaces(floorId) → pick a room
io_create_reservation(title, spaceId, startDate, endDate)
Pre-register a visitor:
io_list_users(search: "host name") → find hostId
io_create_visitor(firstName, lastName, hostId, buildingId, expectedArrival)
io_checkin_visitor(id) → when they arrive
io_checkout_visitor(id) → when they leave
File and resolve a maintenance request:
io_list_spaces(search: "room name") → find spaceId
io_create_maintenance_request(title, spaceId, buildingId)
io_accept_maintenance_request(id)
io_start_maintenance_request(id)
io_complete_maintenance_request(id, resolution: "Fixed the issue")
Log and deliver a package:
io_list_users(search: "recipient name") → find recipientId
io_create_mail(recipientId, buildingId, carrier: "FedEx", trackingNumber: "...")
io_deliver_mail(id) → when delivered to recipient
Schedule and approve a move:
io_list_spaces → find fromSpaceId and toSpaceId
io_create_move(name, fromSpaceId, toSpaceId, scheduledDate)
io_approve_move(id, notes: "Approved")
Notes
- All dates use ISO 8601 format (e.g.
2026-03-21T09:00:00)
- All list tools support
search, limit (default 50, max 100), startAt, orderBy, and orderByType
io_list_floors(buildingId) and io_list_spaces(floorId) use nested API paths when an ID is provided- Building → Floor → Space is the physical location hierarchy
