ioffice-mcp 1.1.0 → 1.2.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "ioffice-mcp",
+  "owner": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "metadata": {
+    "description": "MCP server for iOffice — natural-language workspace and facility management via the iOffice API",
+    "version": "1.1.0"
+  },
+  "plugins": [
+    {
+      "name": "ioffice-mcp",
+      "source": {
+        "source": "npm",
+        "package": "ioffice-mcp",
+        "version": "1.1.0"
+      },
+      "description": "MCP server for iOffice — manage buildings, spaces, reservations, visitors, and more via natural language",
+      "version": "1.1.0",
+      "author": {
+        "name": "Chris Hall"
+      },
+      "homepage": "https://github.com/chrischall/ioffice-mcp",
+      "repository": "https://github.com/chrischall/ioffice-mcp",
+      "license": "MIT",
+      "keywords": ["ioffice", "workspace", "facility-management", "mcp"],
+      "category": "productivity",
+      "mcpServers": {
+        "ioffice": {
+          "command": "npx",
+          "args": ["ioffice-mcp"],
+          "env": {
+            "IOFFICE_HOST": "${IOFFICE_HOST}",
+            "IOFFICE_TOKEN": "${IOFFICE_TOKEN}"
+          }
+        }
+      }
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,24 @@
+{
+  "name": "ioffice-mcp",
+  "version": "1.1.0",
+  "description": "MCP server for iOffice — natural-language workspace and facility management via the iOffice API",
+  "author": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "homepage": "https://github.com/chrischall/ioffice-mcp",
+  "repository": "https://github.com/chrischall/ioffice-mcp",
+  "license": "MIT",
+  "keywords": ["ioffice", "workspace", "facility-management", "mcp"],
+  "skills": "./SKILL.md",
+  "mcpServers": {
+    "ioffice": {
+      "command": "npx",
+      "args": ["ioffice-mcp"],
+      "env": {
+        "IOFFICE_HOST": "${IOFFICE_HOST}",
+        "IOFFICE_TOKEN": "${IOFFICE_TOKEN}"
+      }
+    }
+  }
+}

package/.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "ioffice": {
+      "command": "node",
+      "args": ["dist/index.js"],
+      "env": {
+        "IOFFICE_HOST": "${IOFFICE_HOST}",
+        "IOFFICE_TOKEN": "${IOFFICE_TOKEN}",
+        "IOFFICE_USERNAME": "${IOFFICE_USERNAME}",
+        "IOFFICE_PASSWORD": "${IOFFICE_PASSWORD}"
+      }
+    }
+  }
+}

package/SKILL.md

@@ -0,0 +1,201 @@
+---
+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.
+
+- **npm:** [npmjs.com/package/ioffice-mcp](https://www.npmjs.com/package/ioffice-mcp)
+- **Source:** [github.com/chrischall/ioffice-mcp](https://github.com/chrischall/ioffice-mcp)
+
+## Setup
+
+### Option A — npx (recommended)
+
+Add to `.mcp.json` in your project or `~/.claude/mcp.json`:
+
+```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
+
+```bash
+git clone https://github.com/chrischall/ioffice-mcp
+cd ioffice-mcp
+npm install && npm run build
+```
+
+Then add to `.mcp.json`:
+
+```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