Meeting Room

This MCP server integrates a meeting room reservation system with Claude Desktop, enabling you to search for, view, and create reservations through automated interactions. It handles authentication, exposes room and reservation APIs, and connects to the facility system to streamline meeting scheduling.

How to use

You interact with the Meeting Room MCP server through an MCP client such as Claude Desktop. The server provides three core capabilities: search for available rooms based on date, time, and floor; retrieve the current reservation status for a specific room; and create new reservations with a title when you want to schedule a meeting. The authentication flow uses SSO to obtain a session so subsequent API calls to the meeting system succeed automatically.

How to install

Prerequisites: Python installed on your system, Git available, and a supported shell or command prompt. You may also need to install ChromeDriver if you plan to use the SSO auto-login flow via Selenium.

Step 1: Clone the project

cd meeting-room-mcp```

Step 2: Install dependencies Linux/macOS:

chmod +x setup_project.sh
./setup_project.sh

Windows (manual):

# Create a virtual environment
python -m venv venv

# Activate the virtual environment
.\venv\Scripts\activate  # Windows

# Install dependencies
pip install -r requirements.txt

Step 3: Prepare environment variables cp .env.example .env Edit the .env file to provide actual values for your environment, including any required credentials and paths such as the ChromeDriver location if needed.

Step 4: Set up ChromeDriver (if using Selenium for SSO)

• Check your Chrome version at chrome://version
• Download the matching ChromeDriver
• Place it in the expected path and update CHROMEDRIVER_PATH in your .env

Step 5: Configure Claude Desktop to use the MCP server Include the following in the Claude Desktop configuration under mcpServers. Adjust paths to your Python executable and the MCP script as needed.

{
  "mcpServers": {
    "meeting_room": {
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["-u", "C:\\path\\to\\meeting_room_mcp.py"]
    }
  }
}

Step 6: Start Claude Desktop and begin a new conversation to start using the Meeting Room MCP features.

Configuration and usage notes

The MCP server runs as a local process that authenticates against the SSO portal and then calls the meeting room API to search availability, fetch room details, and create reservations. Typical flow: Claude Desktop → MCP Server → Auth (SSO) → API Modules (rooms, reservations) → Meeting system.

Common tasks and endpoints

Search for available rooms by date, time, office, and floor to find options for your meeting. Retrieve current reservations for a specific room to understand occupancy. Create a new reservation with a title to lock in a meeting time.

Troubleshooting

If you encounter login failures, verify the .env values for credentials, ensure ChromeDriver matches your Chrome version, and inspect mcp_debug.log for detailed errors. If the MCP server cannot be reached from Claude Desktop, double-check the mcpServers configuration and restart Claude Desktop. For import or path issues, ensure PYTHONPATH includes the meeting-room-mcp directory and dependencies are installed.

Available tools

search_available_rooms

Searches for meeting rooms that are available on a given date, start time, duration, office, and floor.

get_room_details

Fetches the current reservation status and details for a specific meeting room on a given date.

create_reservation

Creates a new reservation for a specified room, date, start and end times, with an optional title.