Skip to content
MCP server

Resy MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.4.1
Listing updated
4 days ago

About Resy MCP

Resy MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add resy-mcp --env RESY_PASSWORD='<RESY_PASSWORD>' --env RESY_AUTH_TOKEN='<RESY_AUTH_TOKEN>' -- npx -y resy-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • RESY_EMAILYour Resy account email. Optional — leave unset to use the ContextMint Bridge browser extension instead.
  • RESY_PASSWORDYour Resy account password. Optional — leave unset to use the ContextMint Bridge browser extension instead.
  • RESY_AUTH_TOKENPre-obtained x-resy-auth-token. Overrides email/password and the ContextMint Bridge path. Power users / CI only.
  • RESY_DISABLE_FETCHPROXYSet to '1' to disable the fetchproxy fallback (forces RESY_EMAIL+PASSWORD or RESY_AUTH_TOKEN).
  • RESY_API_KEYPin 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_CACHESet to false to disable the on-disk token cache and re-authenticate on every process start. Defaults to enabled.
  • RESY_TOKEN_FILEAbsolute path for the token cache file. Defaults to $MCP_DATA_DIR/.resy-mcp/token.json.
  • RESY_API_KEY_FILEAbsolute 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_TIMEOUTSeconds 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_PORTPort 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.

Pricing

Open source

Resy MCP FAQ

Is Resy MCP free?

Yes. Resy MCP is open source, so you can use and self-host it for free.

How do I add Resy MCP to Claude Code?

Run this command in your terminal: claude mcp add resy-mcp --env RESY_PASSWORD='<RESY_PASSWORD>' --env RESY_AUTH_TOKEN='<RESY_AUTH_TOKEN>' -- npx -y resy-mcp