How do I use OfficeRnD MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@OfficeRnD MCP Server show me available meeting rooms for next Monday" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

OfficeRnD MCP Server

by EmpathDesign

Overview Schema Related Servers Score Discussions

TypeScript

Remote

OfficeRnD MCP Server

A production-ready Model Context Protocol (MCP) server that exposes the complete OfficeRnD REST API as AI-friendly tools. Enables AI clients (Claude Desktop, ChatGPT, Cursor, VS Code, and others) to interact with your coworking space management platform using natural language.

License: MIT

Related MCP server: Finizi B4B MCP Server

Overview

This monorepo provides everything needed to connect any MCP-compatible AI client to OfficeRnD:

Package	Description
`@officernd/sdk`	Reusable OfficeRnD REST API SDK — OAuth2, retries, pagination
`@officernd/core`	Business logic helpers — available rooms, expiring memberships, etc.
`@officernd/mcp`	MCP server exposing 160+ tools over stdio
`officernd-mcp-vscode`	VS Code extension for credential management and MCP configuration

Architecture

AI Client
(Claude Desktop / ChatGPT / Cursor / VS Code)

           │
           │  MCP (stdio)
           ▼

┌─────────────────────────────────────────┐
│           @officernd/mcp                │
│  Tool Registry (160+ CRUD + business)   │
├─────────────────────────────────────────┤
│           @officernd/core               │
│  Business helpers (rooms, members, …)  │
├─────────────────────────────────────────┤
│           @officernd/sdk                │
│  OAuth2 · HTTP Client · Pagination      │
│  Retries · Rate Limiting · Logging      │
└─────────────────────────────────────────┘

           │
           ▼

    OfficeRnD REST API

The SDK has no MCP dependency, making it reusable in non-MCP contexts.

Installation

Prerequisites

Node.js 22 or later
An OfficeRnD account with API access
OAuth2 Client ID and Client Secret (see Authentication)

Install the MCP Server

npm install -g @officernd/mcp

This installs the officernd-mcp command globally.

Verify Installation

officernd-mcp --version

Authentication

OfficeRnD uses OAuth2 Client Credentials for API access.

Obtain Credentials

Log in to your OfficeRnD dashboard
Go to Settings → Integrations → API
Create a new OAuth2 application
Copy your Client ID and Client Secret
Note your Organization Slug (the subdomain in your OfficeRnD URL, e.g. my-space from my-space.officernd.com)

Required Scopes

For the Flex API v2 (recommended), grant your OAuth2 application the specific scopes it needs. Examples:

flex.community.members.read
flex.community.members.create
flex.space.bookings.read
flex.space.bookings.create
flex.billing.charges.read

Your OfficeRnD OAuth2 application must be configured with the scopes you want the MCP server to use. You must specify at least one scope — OfficeRnD will reject token requests that do not include a scope. Configure the OFFICERND_SCOPES environment variable (space-separated list) for the MCP server, or set officernd.scopes in VS Code settings for the extension.

The token endpoint is rate-limited to 5 requests per minute. The SDK automatically caches tokens and reuses them until 60 seconds before expiry.

Configuration

Configure the server using environment variables:

Variable	Required	Description
`OFFICERND_CLIENT_ID`	✅	Your OAuth2 Client ID
`OFFICERND_CLIENT_SECRET`	✅	Your OAuth2 Client Secret
`OFFICERND_ORG`	Recommended	Organization slug (subdomain)
`OFFICERND_SCOPES`	✅	Space-separated OAuth2 scopes (e.g. `flex.community.members.read`). Required by OfficeRnD.
`OFFICERND_API_VERSION`	No	API version: `v2` (default) or `v1`
`OFFICERND_LOG_LEVEL`	No	Log level: `debug`, `info` (default), `warn`, `error`

Example

export OFFICERND_CLIENT_ID="your_client_id"
export OFFICERND_CLIENT_SECRET="your_client_secret"
export OFFICERND_ORG="my-coworking-space"
export OFFICERND_SCOPES="flex.community.members.read flex.space.bookings.read"
officernd-mcp

Security note: Never hardcode credentials in configuration files. Use environment variables or a secrets manager. The VS Code extension generates MCP config with ${env:...} placeholders so secrets are never written to disk.

MCP Tools

The server automatically generates tools from the resource registry. Every resource supports a consistent set of operations:

CRUD Tools (per resource)

Tool Pattern	Description
`list_{resources}`	List all items with optional filters
`get_{resource}`	Get a specific item by ID
`count_{resources}`	Count items matching filters
`create_{resource}`	Create a new item
`update_{resource}`	Update an existing item
`delete_{resource}`	Delete an item

Supported Resources

Resource	Tools
Members	`list_members`, `get_member`, `count_members`, `create_member`, `update_member`, `delete_member`
Companies	`list_companies`, `get_company`, `count_companies`, `create_company`, `update_company`, `delete_company`
Teams	`list_teams`, `get_team`, `count_teams`, `create_team`, `update_team`, `delete_team`
Memberships	`list_memberships`, `get_membership`, `count_memberships`, `create_membership`, `update_membership`, `delete_membership`
Bookings	`list_bookings`, `get_booking`, `count_bookings`, `create_booking`, `update_booking`, `delete_booking`
Rooms	`list_rooms`, `get_room`, `count_rooms`, `create_room`, `update_room`, `delete_room`
Desks	`list_desks`, `get_desk`, `count_desks`, `create_desk`, `update_desk`, `delete_desk`
Resource Types	`list_resource_types`, `get_resource_type`, `create_resource_type`, `update_resource_type`, `delete_resource_type`
Locations	`list_locations`, `get_location`, `create_location`, `update_location`, `delete_location`
Floors	`list_floors`, `get_floor`, `create_floor`, `update_floor`, `delete_floor`
Amenities	`list_amenities`, `get_amenity`, `create_amenity`, `update_amenity`, `delete_amenity`
Assignments	`list_assignments`, `get_assignment`, `count_assignments`, `create_assignment`, `delete_assignment`
Passes	`list_passes`, `get_pass`, `count_passes`, `create_pass`, `update_pass`, `delete_pass`
Coins	`list_coins`, `get_coin`, `count_coins`
Credits	`list_credits`, `get_credit`, `create_credit`, `update_credit`, `delete_credit`
Invoices	`list_invoices`, `get_invoice`, `count_invoices`, `create_invoice`, `update_invoice`, `delete_invoice`
Payments	`list_payments`, `get_payment`, `count_payments`, `create_payment`, `update_payment`, `delete_payment`
Charges	`list_charges`, `get_charge`, `count_charges`, `create_charge`, `update_charge`, `delete_charge`
Payment Details	`list_payment_details`, `get_payment_detail`, `create_payment_detail`, `delete_payment_detail`
Tax Rates	`list_tax_rates`, `get_tax_rate`
Revenue Accounts	`list_revenue_accounts`, `get_revenue_account`
Resource Rates	`list_resource_rates`, `get_resource_rate`
Cancellation Policies	`list_cancellation_policies`, `get_cancellation_policy`
Plans	`list_plans`, `get_plan`, `create_plan`, `update_plan`, `delete_plan`
Visitors	`list_visitors`, `get_visitor`, `count_visitors`, `create_visitor`, `update_visitor`, `delete_visitor`
Visits	`list_visits`, `get_visit`, `count_visits`, `create_visit`, `update_visit`, `delete_visit`
Events	`list_events`, `get_event`, `count_events`, `create_event`, `update_event`, `delete_event`
Tickets	`list_tickets`, `get_ticket`, `count_tickets`, `create_ticket`, `update_ticket`
Ticket Options	`list_ticket_options`, `get_ticket_option`
Ticket Comments	`list_ticket_comments`, `get_ticket_comment`, `create_ticket_comment`
Posts	`list_posts`, `get_post`, `count_posts`, `create_post`, `delete_post`
Benefits	`list_benefits`, `get_benefit`
Opportunities	`list_opportunities`, `get_opportunity`, `count_opportunities`, `create_opportunity`, `update_opportunity`, `delete_opportunity`
Opportunity Statuses	`list_opportunity_statuses`, `get_opportunity_status`
Contracts	`list_contracts`, `get_contract`, `count_contracts`, `create_contract`, `update_contract`, `delete_contract`
Check-ins	`list_checkins`, `get_checkin`, `count_checkins`, `create_checkin`, `update_checkin`, `delete_checkin`
Fees	`list_fees`, `get_fee`, `create_fee`, `update_fee`, `delete_fee`
Reception Flows	`list_reception_flows`, `get_reception_flow`
Webhooks	`list_webhooks`, `get_webhook`, `create_webhook`, `update_webhook`, `delete_webhook`
Secondary Currencies	`list_secondary_currencies`, `get_secondary_currency`, `update_secondary_currency`
… and more resource types

Business / AI Convenience Tools

Tool	Description
`find_available_rooms`	Find available meeting rooms for a time range
`find_memberships_expiring_soon`	Find memberships expiring within N days
`get_todays_visitors`	Get all visitors for today
`get_todays_bookings`	Get all room bookings for today
`get_unpaid_invoices`	Get all outstanding invoices
`get_members_by_company`	Get all members from a company
`get_active_members`	Get all currently active members

Example AI Interactions

"Show me all members who joined in the last 30 days"
→ list_members with date filters

"Find available meeting rooms tomorrow at 2pm for 8 people"
→ find_available_rooms

"Which memberships are expiring this month?"
→ find_memberships_expiring_soon with daysUntilExpiry: 30

"Show today's visitors"
→ get_todays_visitors

"How many unpaid invoices do we have?"
→ get_unpaid_invoices

Client Setup

VS Code (Copilot)

Option A: Using the VS Code Extension (Recommended)

Install the OfficeRnD MCP extension from the VS Code Marketplace
Run command: OfficeRnD: Configure Connection
Enter your Client ID, Client Secret, and Organization Slug
Run command: OfficeRnD: Generate MCP Configuration
The extension writes .vscode/mcp.json with secure environment variable references

Option B: Manual Configuration

Create or edit .vscode/mcp.json in your workspace:

{
  "servers": {
    "officernd": {
      "command": "officernd-mcp",
      "env": {
        "OFFICERND_CLIENT_ID": "${env:OFFICERND_CLIENT_ID}",
        "OFFICERND_CLIENT_SECRET": "${env:OFFICERND_CLIENT_SECRET}",
        "OFFICERND_ORG": "your-org-slug"
      }
    }
  }
}

Set environment variables in your shell profile (.bashrc, .zshrc, etc.):

export OFFICERND_CLIENT_ID="your_client_id"
export OFFICERND_CLIENT_SECRET="your_client_secret"

Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "officernd": {
      "command": "officernd-mcp",
      "env": {
        "OFFICERND_CLIENT_ID": "your_client_id",
        "OFFICERND_CLIENT_SECRET": "your_client_secret",
        "OFFICERND_ORG": "your-org-slug"
      }
    }
  }
}

Restart Claude Desktop. You should see "officernd" in the MCP servers list.

Cursor

Create or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "officernd": {
      "command": "officernd-mcp",
      "env": {
        "OFFICERND_CLIENT_ID": "your_client_id",
        "OFFICERND_CLIENT_SECRET": "your_client_secret",
        "OFFICERND_ORG": "your-org-slug"
      }
    }
  }
}

ChatGPT

ChatGPT supports MCP via the OpenAI desktop app. Configure in the app's MCP settings using the same officernd-mcp command with the required environment variables.

VS Code Extension

The officernd-mcp-vscode extension provides a first-class developer experience:

Commands

Command	Description
`OfficeRnD: Configure Connection`	Guided setup wizard for credentials
`OfficeRnD: Test Connection`	Verify credentials and API connectivity
`OfficeRnD: Show Configuration`	Display current config (secrets masked)
`OfficeRnD: Update Credentials`	Update stored credentials
`OfficeRnD: Clear Credentials`	Remove all stored credentials
`OfficeRnD: Generate MCP Configuration`	Write `.vscode/mcp.json` with env var placeholders
`OfficeRnD: Open Logs`	Open the output channel for debug logs
`OfficeRnD: Add All Scopes`	Populate `officernd.scopes` with all available OfficeRnD scopes

Status Bar

The status bar shows the current connection state:

$(check) OfficeRnD Connected — credentials configured
$(warning) OfficeRnD Disconnected — no credentials

Security

Credentials are stored in VS Code's SecretStorage (OS keychain). Secrets are never written to:

settings.json
Workspace settings
mcp.json — env var references (${env:...}) are used instead

Development

Prerequisites

node --version  # Must be >= 22
npm --version

Clone and Install

git clone https://github.com/EmpathDesign/OfficeRnD_MCP.git
cd OfficeRnD_MCP
npm install

Build

npm run build

Test

npm test

Lint and Format

npm run lint          # ESLint
npm run format:check  # Prettier check
npm run format        # Prettier fix

Monorepo Structure

packages/
├── sdk/          @officernd/sdk     — REST API SDK
├── core/         @officernd/core    — Business helpers
├── mcp/          @officernd/mcp     — MCP server + CLI
└── vscode/       officernd-mcp-vscode — VS Code extension

Adding a New Resource

The resource registry in packages/sdk/src/resources/registry.ts is the single source of truth. Add a new entry:

{
  name: 'my_resource',
  path: '/my-resources',
  description: 'Description of the resource',
  operations: ['list', 'get', 'create', 'update', 'delete', 'count'],
}

The MCP server automatically generates all tools from this registry. No additional code changes are needed.

Troubleshooting

Server doesn't start

Error: OFFICERND_CLIENT_ID and OFFICERND_CLIENT_SECRET environment variables are required.

Ensure both environment variables are set before running officernd-mcp.

Authentication errors

OAuth2 token request failed: 401

Verify your Client ID and Client Secret are correct
Ensure the OAuth2 application has the Flex API scopes your workflows need (for example flex.community.members.read)
Check that your organization slug matches your OfficeRnD URL

Rate limiting

The token endpoint is limited to 5 requests/minute. The SDK caches tokens automatically — this should only occur if the server is restarted very frequently.

404 errors on API calls

Verify your OFFICERND_ORG is set to the correct organization slug
Check that the API version (OFFICERND_API_VERSION) matches what your account supports

Enabling debug logging

OFFICERND_LOG_LEVEL=debug officernd-mcp

Logs are written to stderr to keep MCP's stdout protocol clean.

Deferred Endpoints

The following OfficeRnD API resources are not yet implemented. They are documented here for follow-up:

Resource	Notes
Access Control	Badge/door access management
Occupancy tracking	Real-time sensor data
Checkout flows	Online booking checkout
Multi-org federation	Cross-organization queries
Webhooks management	Endpoint delivery status
Document uploads	Binary file operations
OpenAPI code generation	Automatic SDK regeneration

The RESOURCES registry in packages/sdk/src/resources/registry.ts is designed for declarative extension — adding a new resource requires a single entry.

Contributing

Fork the repository
Create a feature branch: git checkout -b feature/my-feature
Make changes and add tests
Verify: npm run build && npm test && npm run lint
Submit a pull request

All PRs run the CI workflow (lint → format check → build → test) automatically.

License

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

8Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/EmpathDesign/OfficeRnD_MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

OfficeRnD MCP Server

Table of Contents

Overview

Architecture

Installation

Prerequisites

Install the MCP Server

Verify Installation

Authentication

Obtain Credentials

Required Scopes

Configuration

Example

MCP Tools

CRUD Tools (per resource)

Supported Resources

Business / AI Convenience Tools

Example AI Interactions

Client Setup

VS Code (Copilot)

Option A: Using the VS Code Extension (Recommended)

Option B: Manual Configuration

Claude Desktop

Cursor

ChatGPT

VS Code Extension

Commands

Status Bar

Security

Development

Prerequisites

Clone and Install

Build

Test

Lint and Format

Monorepo Structure

Adding a New Resource

Troubleshooting

Server doesn't start

Authentication errors

Rate limiting

404 errors on API calls

Enabling debug logging

Deferred Endpoints

Contributing

License

Maintenance

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API