NestDaddy

Zola Mcp

io.github.chrischall/zola-mcp · v2.2.2

Zola wedding planning for Claude — vendors, budget, guests, seating, registry, and RSVPs

Connect Runs on your machine

Terminal
claude mcp add zola-mcp -e ZOLA_REFRESH_TOKEN=<ZOLA_REFRESH_TOKEN> -e ZOLA_DISABLE_FETCHPROXY=<ZOLA_DISABLE_FETCHPROXY> -e ZOLA_TOKEN_CACHE=<ZOLA_TOKEN_CACHE> -e ZOLA_TOKEN_FILE=<ZOLA_TOKEN_FILE> -e ZOLA_ACCOUNT_ID=<ZOLA_ACCOUNT_ID> -e ZOLA_REGISTRY_ID=<ZOLA_REGISTRY_ID> -e ZOLA_WEDDING_ID=<ZOLA_WEDDING_ID> -e ZOLA_SESSION_TOKEN=<ZOLA_SESSION_TOKEN> -e FETCHPROXY_WS_PORT=<FETCHPROXY_WS_PORT> -e FETCHPROXY_WS_HOST=<FETCHPROXY_WS_HOST> -e FETCHPROXY_IDENTITY_DIR=<FETCHPROXY_IDENTITY_DIR> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "zola-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ZOLA_REFRESH_TOKEN": "<ZOLA_REFRESH_TOKEN>",
        "ZOLA_DISABLE_FETCHPROXY": "<ZOLA_DISABLE_FETCHPROXY>",
        "ZOLA_TOKEN_CACHE": "<ZOLA_TOKEN_CACHE>",
        "ZOLA_TOKEN_FILE": "<ZOLA_TOKEN_FILE>",
        "ZOLA_ACCOUNT_ID": "<ZOLA_ACCOUNT_ID>",
        "ZOLA_REGISTRY_ID": "<ZOLA_REGISTRY_ID>",
        "ZOLA_WEDDING_ID": "<ZOLA_WEDDING_ID>",
        "ZOLA_SESSION_TOKEN": "<ZOLA_SESSION_TOKEN>",
        "FETCHPROXY_WS_PORT": "<FETCHPROXY_WS_PORT>",
        "FETCHPROXY_WS_HOST": "<FETCHPROXY_WS_HOST>",
        "FETCHPROXY_IDENTITY_DIR": "<FETCHPROXY_IDENTITY_DIR>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "zola-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ZOLA_REFRESH_TOKEN": "<ZOLA_REFRESH_TOKEN>",
        "ZOLA_DISABLE_FETCHPROXY": "<ZOLA_DISABLE_FETCHPROXY>",
        "ZOLA_TOKEN_CACHE": "<ZOLA_TOKEN_CACHE>",
        "ZOLA_TOKEN_FILE": "<ZOLA_TOKEN_FILE>",
        "ZOLA_ACCOUNT_ID": "<ZOLA_ACCOUNT_ID>",
        "ZOLA_REGISTRY_ID": "<ZOLA_REGISTRY_ID>",
        "ZOLA_WEDDING_ID": "<ZOLA_WEDDING_ID>",
        "ZOLA_SESSION_TOKEN": "<ZOLA_SESSION_TOKEN>",
        "FETCHPROXY_WS_PORT": "<FETCHPROXY_WS_PORT>",
        "FETCHPROXY_WS_HOST": "<FETCHPROXY_WS_HOST>",
        "FETCHPROXY_IDENTITY_DIR": "<FETCHPROXY_IDENTITY_DIR>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "zola-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ZOLA_REFRESH_TOKEN": "<ZOLA_REFRESH_TOKEN>",
        "ZOLA_DISABLE_FETCHPROXY": "<ZOLA_DISABLE_FETCHPROXY>",
        "ZOLA_TOKEN_CACHE": "<ZOLA_TOKEN_CACHE>",
        "ZOLA_TOKEN_FILE": "<ZOLA_TOKEN_FILE>",
        "ZOLA_ACCOUNT_ID": "<ZOLA_ACCOUNT_ID>",
        "ZOLA_REGISTRY_ID": "<ZOLA_REGISTRY_ID>",
        "ZOLA_WEDDING_ID": "<ZOLA_WEDDING_ID>",
        "ZOLA_SESSION_TOKEN": "<ZOLA_SESSION_TOKEN>",
        "FETCHPROXY_WS_PORT": "<FETCHPROXY_WS_PORT>",
        "FETCHPROXY_WS_HOST": "<FETCHPROXY_WS_HOST>",
        "FETCHPROXY_IDENTITY_DIR": "<FETCHPROXY_IDENTITY_DIR>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
ZOLA_REFRESH_TOKEN
Optional, secret
Zola refresh token JWT (~1 year lifetime). Optional — when unset, the MCP falls back to the ContextMint Bridge browser extension to read the `usr` cookie from your signed-in zola.com tab, and caches it so later starts need no browser.
ZOLA_DISABLE_FETCHPROXY
Optional
Set to '1' to opt out of the fetchproxy browser fallback (headless / CI). With it set and no ZOLA_REFRESH_TOKEN, auth is a hard error unless a previous bootstrap already cached a token — reading that file is not opening a browser, so the cache stays readable.
ZOLA_TOKEN_CACHE
Optional
Set to 'false' to disable the on-disk refresh-token cache and ask the browser on every start. Defaults to enabled. Inert when ZOLA_REFRESH_TOKEN is set — there is no bootstrap to skip.
ZOLA_TOKEN_FILE
Optional
Absolute path for the refresh-token cache file. Defaults to $MCP_DATA_DIR/.zola-mcp/refresh-token.json, else the same path under $HOME.
ZOLA_ACCOUNT_ID
Optional
Overrides the account id normally read from GET /v3/users/me/context. Set it only to pin a specific account.
ZOLA_REGISTRY_ID
Optional
Overrides the registry id normally read from the same context call.
ZOLA_WEDDING_ID
Optional
Overrides the wedding id normally read from the same context call.
ZOLA_SESSION_TOKEN
Optional, secret
A seed session token (JWT). The client refreshes it about five minutes before its exp, so this is a starting point rather than a long-lived credential.
FETCHPROXY_WS_PORT
Optional
Localhost port of the fetchproxy concentrator the ContextMint Bridge extension connects to (default 37149). Every MCP on one machine shares it, so move it for all of them or not at all.
FETCHPROXY_WS_HOST
Optional
Bind interface for the fetchproxy concentrator, a literal IP only (default 127.0.0.1). Keep on loopback; it exists for hosted deployments that run each MCP in its own network namespace.
FETCHPROXY_IDENTITY_DIR
Optional
Absolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

Details

Package[email protected] (NPM, stdio)
First published7 Nov 2026
Last updated7 Nov 2026
Registry nameio.github.chrischall/zola-mcp

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.