samgwd/dish-mcp

DiSH MCP Server

A Model Context Protocol (MCP) server for the DiSH room booking site. It exposes tools to check availability, book rooms, and cancel bookings so assistants like Cursor or Claude can manage your reservations.

What it can do

• Search room availability across your DiSH locations
• Create bookings on your behalf
• Cancel or reschedule existing bookings
• Pair with calendar tools (e.g., Google Calendar MCP) to coordinate bookings with your calendar availability.

Example prompts:

• "Book meeting rooms for all my standups this week."
• "Reschedule my 1-1 with John to tomorrow afternoon when we’re both free and a room is open."
• "Book a meeting room for all my customer demos for the next 2 months."

Requirements

• Python 3.10+
• uv for dependency management

Setup

uv sync

Configuration

The server needs three environment variables:

• DISH_COOKIE — your DiSH connect.sid session cookie
• TEAM_ID — your DiSH team ID
• MEMBER_ID — your DiSH member ID

Automatic credential retrieval (recommended)

The easiest way to get your credentials is to use the included script:

# Install Playwright browser (first time only)
uv run playwright install chromium

# Run the credential retrieval script
uv run src/get_credentials.py

This will:

1. Open a browser window for you to log in to DiSH
2. Automatically detect when you've reached the dashboard
3. Capture your cookie, team ID, and member ID
4. Save them to your .env file

Manual credential retrieval

If the automatic method doesn't work, you can retrieve credentials manually:

Getting your connect.sid cookie

1. Log in to DiSH in your browser.
2. Open Developer Tools (F12 / Cmd+Option+I).
3. In Application/Storage > Cookies, select the DiSH domain.
4. Copy the connect.sid value (looks like s%3A...).
5. In your .env file, set DISH_COOKIE to connect.sid=<value>.

Getting your team and member IDs

1. Log in to DiSH in your browser.
2. Open Developer Tools (F12 / Cmd+Option+I).
3. In the Network tab, find a request to occurrences (or booking-policy).
4. In the request URL or payload, look for the team and member values.
5. In your .env file, set TEAM_ID and MEMBER_ID to the respective values.

Keep this secret. Do not commit cookies, team IDs, member IDs, or .env files to source control. Regenerate the cookie if it stops working or was ever exposed.

Run the MCP server

uv run fastmcp run src/mcp_server.py

Configure your client

Cursor

"Dish MCP": {
  "command": "<PATH_TO_VENV>/bin/fastmcp",
  "args": ["run", "<PATH_TO_REPO>/src/mcp_server.py"],
  "cwd": "<PATH_TO_REPO>",
  "env": {
    "DISH_COOKIE": "<connect.sid=...>",
    "TEAM_ID": "<YOUR_TEAM_ID>",
    "MEMBER_ID": "<YOUR_MEMBER_ID>"
  },
  "transport": "stdio"
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "Dish MCP": {
      "command": "<PATH_TO_VENV>/bin/fastmcp",
      "args": ["run", "<PATH_TO_REPO>/src/mcp_server.py"],
      "cwd": "<PATH_TO_REPO>",
      "env": {
        "DISH_COOKIE": "<connect.sid=...>",
        "TEAM_ID": "<YOUR_TEAM_ID>",
        "MEMBER_ID": "<YOUR_MEMBER_ID>"
      }
    }
  }
}

The cookie expires periodically. Run uv run src/get_credentials.py to get fresh credentials if authentication fails.