# 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](https://github.com/nspady/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`](https://github.com/astral-sh/uv) for dependency management

## Setup
```bash
uv sync
```

## Configuration
Required:
- `TEAM_ID` — your DiSH team ID
- `MEMBER_ID` — your DiSH member ID

Authentication:
- `DISH_COOKIE` — your DiSH `connect.sid` session cookie
- `DISH_EMAIL` — optional, enables non-interactive login when the cookie is missing or expired
- `DISH_PASSWORD` — optional, enables non-interactive login when the cookie is missing or expired

Optional transport configuration (for HTTP mode):
- `MCP_TRANSPORT` — `stdio` (default) or `http`
- `MCP_PORT` — port for HTTP transport (default: `8000`)
- `MCP_HOST` — host for HTTP transport (default: `127.0.0.1`)

### Non-interactive cookie refresh

If you want Claude to keep working when `connect.sid` expires, put these values in `.env`:

```bash
TEAM_ID=<YOUR_TEAM_ID>
MEMBER_ID=<YOUR_MEMBER_ID>
DISH_EMAIL=you@example.com
DISH_PASSWORD=<YOUR_PASSWORD>
```

With that setup:
1. The MCP will create `DISH_COOKIE` automatically if it is missing.
2. If the API returns `401` or `403`, the MCP will log in again headlessly, update `DISH_COOKIE` in `.env`, and retry the request once.
3. `TEAM_ID` and `MEMBER_ID` stay stable in `.env`; only the session cookie rotates.

This only works if your DiSH account supports direct email/password login. If your login goes through Google, Microsoft, or another SSO flow, there is no silent refresh path in this repo and you will need the browser-based flow below.

### Automatic credential retrieval (manual browser flow)

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

```bash
# 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

### stdio transport (default)
For use with Cursor or Claude Desktop:
```bash
uv run fastmcp run src/mcp_server.py
```

### HTTP transport
For remote access or web-based clients:
```bash
# Default: http://127.0.0.1:8000
uv run python src/mcp_server.py --transport http

# Custom port and host
uv run python src/mcp_server.py --transport http --port 3000 --host 0.0.0.0
```

Or using environment variables:
```bash
MCP_TRANSPORT=http MCP_PORT=8000 uv run python src/mcp_server.py
```

The HTTP server exposes an SSE endpoint at `http://<host>:<port>/sse`.

## Configure your client

### Cursor
```json
"Dish MCP": {
  "command": "<PATH_TO_VENV>/bin/fastmcp",
  "args": ["run", "<PATH_TO_REPO>/src/mcp_server.py"],
  "cwd": "<PATH_TO_REPO>",
  "transport": "stdio"
}
```

### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "Dish MCP": {
      "command": "<PATH_TO_VENV>/bin/fastmcp",
      "args": ["run", "<PATH_TO_REPO>/src/mcp_server.py"],
      "cwd": "<PATH_TO_REPO>"
    }
  }
}
```

The server loads auth values from `.env` automatically. Keep `.env` as the source of truth for `DISH_COOKIE`, `TEAM_ID`, `MEMBER_ID`, `DISH_EMAIL`, and `DISH_PASSWORD` instead of hardcoding those values in your Claude config.