Resy MCP Server

by chrischallio.github.chrischall/resy-mcpv1.3.2

Resy reservation management — search, book, cancel, favorites, and Priority Notify for Claude

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Resy MCP server

claude mcp add resy -e RESY_PASSWORD='<resy-password>' -e RESY_AUTH_TOKEN='<resy-auth-token>' -- npx -y resy-mcp

{
  "mcpServers": {
    "resy": {
      "command": "npx",
      "args": [
        "-y",
        "resy-mcp"
      ],
      "env": {
        "RESY_PASSWORD": "<resy-password>",
        "RESY_AUTH_TOKEN": "<resy-auth-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "resy": {
      "command": "npx",
      "args": [
        "-y",
        "resy-mcp"
      ],
      "env": {
        "RESY_PASSWORD": "<resy-password>",
        "RESY_AUTH_TOKEN": "<resy-auth-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "resy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "resy-mcp"
      ],
      "env": {
        "RESY_PASSWORD": "<resy-password>",
        "RESY_AUTH_TOKEN": "<resy-auth-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "resy": {
      "command": "npx",
      "args": [
        "-y",
        "resy-mcp"
      ],
      "env": {
        "RESY_PASSWORD": "<resy-password>",
        "RESY_AUTH_TOKEN": "<resy-auth-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
RESY_EMAIL	—	—	Your Resy account email. Optional — leave unset to use the ContextMint Bridge browser extension instead.
RESY_PASSWORD	—	yes	Your Resy account password. Optional — leave unset to use the ContextMint Bridge browser extension instead.
RESY_AUTH_TOKEN	—	yes	Pre-obtained x-resy-auth-token. Overrides email/password and the ContextMint Bridge path. Power users / CI only.
RESY_DISABLE_FETCHPROXY	—	—	Set to '1' to disable the fetchproxy fallback (forces RESY_EMAIL+PASSWORD or RESY_AUTH_TOKEN).
RESY_API_KEY	—	—	Pin the api key, beating both the key captured from the live site and the compiled-in default. Rotation does not require it: the key is captured and cached automatically.
RESY_TOKEN_CACHE	—	—	Set to false to disable the on-disk token cache and re-authenticate on every process start. Defaults to enabled.
RESY_TOKEN_FILE	—	—	Absolute path for the token cache file. Defaults to $MCP_DATA_DIR/.resy-mcp/token.json.
RESY_API_KEY_FILE	—	—	Absolute path for the api-key cache file. Defaults to $MCP_DATA_DIR/.resy-mcp/api-key.json. Holds the bare key captured from the live site, which takes precedence over the compiled-in default.
RESY_CAPTURE_TIMEOUT	—	—	Seconds to wait for the signed-in page to make an API call the bridge can read the auth token from. Defaults to 30. Capture resolves on the next matching request, so an idle tab needs a longer window than a busy one.
RESY_WS_PORT	—	—	Port for the fetchproxy bridge. The whole fleet shares 37149 (the ContextMint Bridge extension dials it), so override only for local development, test isolation, or a hosted bridged registration — this is the variable to name in the registration's bridgePortEnv.

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-09 · 1d ago · GitHub
Latest release
2026-10-07 · 3d ago · GitHub · v1.3.2
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 3d ago · official registry · v1.3.2

FAQ

›How do I install the Resy MCP server in Claude Code?

Run: claude mcp add resy -e RESY_PASSWORD='<resy-password>' -e RESY_AUTH_TOKEN='<resy-auth-token>' -- npx -y resy-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Resy require an API key?

Yes. It expects RESY_PASSWORD, RESY_AUTH_TOKEN, of which 2 are secrets.

›Can I use Resy as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Resy in the official MCP registry?

Yes, as io.github.chrischall/resy-mcp.