zola-mcp

MCP server for Zola — 30 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

Two options:

Option A — fetchproxy extension (recommended). Install the fetchproxy 0.3.0 extension, sign into zola.com once, and leave ZOLA_REFRESH_TOKEN unset. The MCP reads the HttpOnly usr cookie on demand and goes direct-to-API from Node thereafter.

Option B — manual DevTools copy. After signing in at zola.com, open DevTools → Application → Cookies, copy the usr value, and paste it into your config as ZOLA_REFRESH_TOKEN. Token lasts ~1 year.

Credentials

| Env var | Required | Notes | |---------|----------|-------| | ZOLA_REFRESH_TOKEN | Conditional | Mobile API JWT refresh token (~1 year lifetime). Unset = fetchproxy fallback | | ZOLA_DISABLE_FETCHPROXY | No | Set to 1 to opt out of the fetchproxy fallback (headless / CI) | | ZOLA_ACCOUNT_ID | No | Auto-resolved from API; optional override | | ZOLA_REGISTRY_ID | No | Auto-resolved from API; optional override |

Tools

Vendors (5 tools)

| Tool | Description | |------|-------------| | list_vendors | List all booked vendors with details | | search_vendors | Search for vendors by name within a category | | add_vendor | Book a new vendor | | update_vendor | Update a booked vendor's details | | remove_vendor | Unbook a vendor |

Budget (2 tools)

| Tool | Description | |------|-------------| | get_budget | Get wedding budget summary with all items | | update_budget_item | Update a budget item's cost or note |

Guests (4 tools)

| Tool | Description | |------|-------------| | list_guests | List all guest groups with stats | | add_guest | Add a new guest group (household) | | update_guest_address | Update a guest group's mailing address | | remove_guest | Remove a guest group |

Seating (4 tools)

| Tool | Description | |------|-------------| | list_seating_charts | List all seating charts | | get_seating_chart | Get chart with tables, seats, and occupants | | list_unseated_guests | List guests not yet assigned a seat | | assign_seat | Assign a guest to a specific seat |

Inquiries (3 tools)

| Tool | Description | |------|-------------| | list_inquiries | List all vendor inquiries with status | | get_inquiry_conversation | Get full conversation for an inquiry | | mark_inquiry_read | Mark an inquiry conversation as read |

Events & RSVPs (6 tools)

| Tool | Description | |------|-------------| | list_events | List all wedding events with RSVP counts | | track_rsvps | Get RSVP tracking per event | | update_event | Update event details (time, venue, dress code) | | set_event_guests | Bulk set which guest groups are invited to an event | | invite_guest_to_event | Invite one guest or group to an event | | remove_event_invitation | Remove an event invitation for a guest or group |

Registry & Gifts (2 tools)

| Tool | Description | |------|-------------| | get_registry | View the wedding registry with categories | | get_gift_tracker | View gifts received, values, thank-you status |

Discovery (4 tools)

| Tool | Description | |------|-------------| | get_wedding_dashboard | Get wedding planning dashboard overview | | search_storefronts | Search vendor marketplace by category/location | | get_storefront | Get full vendor storefront details | | list_favorites | List all favorited/saved vendors |

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
• "Invite all family to the rehearsal dinner" → list_events + list_guests → set_event_guests

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; sign back into zola.com (fetchproxy path) or copy a fresh usr cookie from DevTools to renew