Skip to content
MCP server

Zola MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
2.2.2
Listing updated
5 days ago

About Zola MCP

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

Install

Run in a terminal

claude mcp add zola-mcp --env ZOLA_REFRESH_TOKEN='<ZOLA_REFRESH_TOKEN>' --env ZOLA_SESSION_TOKEN='<ZOLA_SESSION_TOKEN>' -- npx -y zola-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "zola-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zola-mcp"
      ],
      "env": {
        "ZOLA_REFRESH_TOKEN": "<ZOLA_REFRESH_TOKEN>",
        "ZOLA_SESSION_TOKEN": "<ZOLA_SESSION_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "zola-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zola-mcp"
      ],
      "env": {
        "ZOLA_REFRESH_TOKEN": "<ZOLA_REFRESH_TOKEN>",
        "ZOLA_SESSION_TOKEN": "<ZOLA_SESSION_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "zola-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "zola-mcp"
      ],
      "env": {
        "ZOLA_REFRESH_TOKEN": "<ZOLA_REFRESH_TOKEN>",
        "ZOLA_SESSION_TOKEN": "<ZOLA_SESSION_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "zola-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zola-mcp"
      ],
      "env": {
        "ZOLA_REFRESH_TOKEN": "<ZOLA_REFRESH_TOKEN>",
        "ZOLA_SESSION_TOKEN": "<ZOLA_SESSION_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "zola-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zola-mcp"
      ],
      "env": {
        "ZOLA_REFRESH_TOKEN": "<ZOLA_REFRESH_TOKEN>",
        "ZOLA_SESSION_TOKEN": "<ZOLA_SESSION_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ZOLA_REFRESH_TOKENZola 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_FETCHPROXYSet 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_CACHESet 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_FILEAbsolute 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_IDOverrides the account id normally read from GET /v3/users/me/context. Set it only to pin a specific account.
  • ZOLA_REGISTRY_IDOverrides the registry id normally read from the same context call.
  • ZOLA_WEDDING_IDOverrides the wedding id normally read from the same context call.
  • ZOLA_SESSION_TOKENA 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_PORTLocalhost 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_HOSTBind 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_DIRAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

Pricing

Open source

Zola MCP FAQ

Is Zola MCP free?

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

How do I add Zola MCP to Claude Code?

Run this command in your terminal: claude mcp add zola-mcp --env ZOLA_REFRESH_TOKEN='<ZOLA_REFRESH_TOKEN>' --env ZOLA_SESSION_TOKEN='<ZOLA_SESSION_TOKEN>' -- npx -y zola-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers