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_storefrontswithtaxonomy_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
usrcookie from DevTools to renew
