zola-mcp

MCP server for Zola — 27 tools for managing your entire wedding via the Zola mobile API.

• npm: npmjs.com/package/zola-mcp
• Source: github.com/chrischall/zola-mcp

Setup

Option A — Claude Code (direct MCP)

Add to .mcp.json in your project or ~/.claude/mcp.json:

{
  "mcpServers": {
    "zola": {
      "command": "npx",
      "args": ["-y", "zola-mcp"],
      "env": {
        "ZOLA_REFRESH_TOKEN": "your-refresh-token-jwt"
      }
    }
  }
}

Option B — from source

git clone https://github.com/chrischall/zola-mcp
cd zola-mcp
npm install && npm run build

Getting your refresh token

Run the setup script (one-time, token lasts ~1 year):

npm run auth               # prints the token to the console
npm run auth -- .env       # writes ZOLA_REFRESH_TOKEN=\x3Ctoken> to .env

This launches Chrome with a dedicated profile, waits for you to sign in to zola.com, then captures the usr cookie (a ~1-year JWT). Use the printed value with Claude Desktop / MCPB configs, or the .env form when running from source.

If you'd rather not run Chrome via the script, you can also copy the usr cookie manually from DevTools → Application → Cookies after signing in at zola.com.

Credentials

Tools

Vendors (5 tools)

Budget (2 tools)

Guests (4 tools)

Seating (4 tools)

Inquiries (3 tools)

Events & RSVPs (3 tools)

Registry & Gifts (2 tools)

Discovery (4 tools)

Workflows

• "How's wedding planning going?" → get_wedding_dashboard
• "Who hasn't RSVP'd?" → track_rsvps
• "Find a photographer in Charlotte" → search_storefronts with taxonomy_node_id: 2, city: Charlotte, state: NC
• "Seat Jennifer at Table 1" → list_unseated_guests → get_seating_chart → assign_seat
• "Any new vendor messages?" → list_inquiries (filter unread) → get_inquiry_conversation
• "Update the venue cost to $25,000" → get_budget → update_budget_item
• "Add my cousin Mike to the guest list" → add_guest

Notes

• All tools use the Zola mobile API (mobile-api.zola.com) with Bearer JWT auth
• Account and registry IDs are auto-resolved from the API on first use
• Refresh token expires after ~1 year; re-run setup-auth.sh to renew