chrischall avatar

Zola Mcp

chrischall/zola-mcp

Wraps the Zola wedding planning API so Claude can manage your vendors, budget, guest list, seating chart, RSVPs, and registry through natural language. Uses a refresh token or the fetchproxy Chrome extension to authenticate, then exposes 27 tools across eight domains: search vendors by category and location, update budget line items, add or remove guests, assign seats at tables, check inquiry status, and track gifts. Ships with auto-run permissions for reads and confirmation prompts for writes. Worth noting the maintainer is transparent about this being AI-generated code and lays out Zola's terms around automated access. If you're planning a wedding on Zola and want to ask "who hasn't RSVP'd?" instead of clicking through dashboards, this handles the API choreography.

GitHub stars
3
tools
77
auth
Secret needed
transport
STDIO
env vars
11
last updated
Nov 7, 2026

Tools

77 tools

Public tool metadata for what this MCP can expose to an agent.

list_vendorsList all booked vendors

List all booked vendors

No parameter schema in public metadata yet.

search_vendorsSearch vendors by name/category

Search vendors by name/category

No parameter schema in public metadata yet.

add_vendorBook a new vendor

Book a new vendor

No parameter schema in public metadata yet.

update_vendorUpdate vendor details

Update vendor details

No parameter schema in public metadata yet.

remove_vendorUnbook a vendor

Unbook a vendor

No parameter schema in public metadata yet.

get_budgetBudget summary with all items

Budget summary with all items

No parameter schema in public metadata yet.

update_budget_itemUpdate cost or note

Update cost or note

No parameter schema in public metadata yet.

list_guestsList all guest groups with stats — names, tier and RSVP state by default; view: "full" adds addresses, emails and phones

List all guest groups with stats — names, tier and RSVP state by default; view: "full" adds addresses, emails and phones

No parameter schema in public metadata yet.

add_guestAdd a guest group

Add a guest group

No parameter schema in public metadata yet.

update_guest_addressUpdate mailing address

Update mailing address

No parameter schema in public metadata yet.

remove_guestRemove a guest group (with its RSVPs and seats)

Remove a guest group (with its RSVPs and seats)

No parameter schema in public metadata yet.

list_seating_chartsList seating charts

List seating charts

No parameter schema in public metadata yet.

get_seating_chartChart with tables/seats/occupants

Chart with tables/seats/occupants

No parameter schema in public metadata yet.

list_unseated_guestsGuests not yet seated

Guests not yet seated

No parameter schema in public metadata yet.

assign_seatAssign guest to a seat

Assign guest to a seat

No parameter schema in public metadata yet.

list_inquiriesAll vendor inquiries with status

All vendor inquiries with status

No parameter schema in public metadata yet.

get_inquiry_conversationFull conversation messages

Full conversation messages

No parameter schema in public metadata yet.

mark_inquiry_readMark as read

Mark as read

No parameter schema in public metadata yet.

list_eventsAll events with RSVP counts

All events with RSVP counts

No parameter schema in public metadata yet.

track_rsvpsRSVP tracking per event

RSVP tracking per event

No parameter schema in public metadata yet.

get_gift_trackerGifts received, thank-you status

Gifts received, thank-you status

No parameter schema in public metadata yet.

get_registryRegistry items with per-item purchase state; paged via limit/offset

Registry items with per-item purchase state; paged via limit/offset

No parameter schema in public metadata yet.

update_eventUpdate event details

Update event details

No parameter schema in public metadata yet.

set_event_guestsSet which guest groups are invited to an event (bulk)

Set which guest groups are invited to an event (bulk)

No parameter schema in public metadata yet.

invite_guest_to_eventInvite a single guest or guest group to an event (additive — does not affect other events)

Invite a single guest or guest group to an event (additive — does not affect other events)

No parameter schema in public metadata yet.

remove_event_invitationRemove an event invitation for a single guest or guest group

Remove an event invitation for a single guest or guest group

No parameter schema in public metadata yet.

search_registry_productsBrowse Zola products in a category, scoped to your registry

Browse Zola products in a category, scoped to your registry

No parameter schema in public metadata yet.

add_registry_itemAdd a product (by SKU) to the registry

Add a product (by SKU) to the registry

No parameter schema in public metadata yet.

update_registry_itemUpdate an existing registry item — all fields must be supplied (it's a full replace)

Update an existing registry item — all fields must be supplied (it's a full replace)

No parameter schema in public metadata yet.

remove_registry_itemRemove an item from the registry that guests shop from

Remove an item from the registry that guests shop from

No parameter schema in public metadata yet.

reconcile_registryJoins the registry against the gift tracker: DUPLICATE_RISK, UNATTRIBUTED, ORPHAN_ORDER, MATCHED

Joins the registry against the gift tracker: DUPLICATE_RISK, UNATTRIBUTED, ORPHAN_ORDER, MATCHED

No parameter schema in public metadata yet.

list_pagesList all wedding-website pages with their IDs, types, display order, visibility, and theme info

List all wedding-website pages with their IDs, types, display order, visibility, and theme info

No parameter schema in public metadata yet.

set_page_hiddenShow or hide a page on the wedding website

Show or hide a page on the wedding website

No parameter schema in public metadata yet.

reorder_pagesReorder pages in the website navigation

Reorder pages in the website navigation

No parameter schema in public metadata yet.

update_pageUpdate page-level metadata (title, intro copy, nav title, visibility, layout customization)

Update page-level metadata (title, intro copy, nav title, visibility, layout customization)

No parameter schema in public metadata yet.

get_wedding_settingsGet top-level wedding settings: title, URL slug, partner names, date, city, hashtag, guest count, search visibility

Get top-level wedding settings: title, URL slug, partner names, date, city, hashtag, guest count, search visibility

No parameter schema in public metadata yet.

update_wedding_settingsUpdate top-level wedding settings

Update top-level wedding settings

No parameter schema in public metadata yet.

list_faqsList all FAQs on the wedding website

List all FAQs on the wedding website

No parameter schema in public metadata yet.

add_faqAdd a new FAQ (question + answer) to the website FAQ page

Add a new FAQ (question + answer) to the website FAQ page

No parameter schema in public metadata yet.

update_faqUpdate an existing FAQ — all three fields must be supplied

Update an existing FAQ — all three fields must be supplied

No parameter schema in public metadata yet.

remove_faqRemove an FAQ from the public website

Remove an FAQ from the public website

No parameter schema in public metadata yet.

list_home_sectionsList the story sections on the website home page

List the story sections on the website home page

No parameter schema in public metadata yet.

add_home_sectionAdd a story section to the home page (title + subtitle + description block)

Add a story section to the home page (title + subtitle + description block)

No parameter schema in public metadata yet.

update_home_sectionUpdate a home page story section — all fields must be supplied

Update a home page story section — all fields must be supplied

No parameter schema in public metadata yet.

remove_home_sectionRemove a story section from the public home page

Remove a story section from the public home page

No parameter schema in public metadata yet.

list_poisList points-of-interest on the "Things to Do" page

List points-of-interest on the "Things to Do" page

No parameter schema in public metadata yet.

add_poiAdd a point-of-interest to the Things-to-Do page

Add a point-of-interest to the Things-to-Do page

No parameter schema in public metadata yet.

update_poiUpdate a point-of-interest

Update a point-of-interest

No parameter schema in public metadata yet.

remove_poiRemove a point-of-interest from the public Things-to-Do page

Remove a point-of-interest from the public Things-to-Do page

No parameter schema in public metadata yet.

list_travel_itemsList hotels, flights, and transportation on the website Travel page

List hotels, flights, and transportation on the website Travel page

No parameter schema in public metadata yet.

add_travel_itemAdd a travel item (hotel, flight, train, car, bus) to the Travel page

Add a travel item (hotel, flight, train, car, bus) to the Travel page

No parameter schema in public metadata yet.

update_travel_itemUpdate a travel item

Update a travel item

No parameter schema in public metadata yet.

remove_travel_itemRemove a travel item from the public Travel page

Remove a travel item from the public Travel page

No parameter schema in public metadata yet.

get_current_themeGet the currently-selected website theme: key, name, swatch color, layout type

Get the currently-selected website theme: key, name, swatch color, layout type

No parameter schema in public metadata yet.

get_website_customizationsGet current website colors, font settings, and available font/color options

Get current website colors, font settings, and available font/color options

No parameter schema in public metadata yet.

search_themesBrowse the catalog of available wedding-website themes

Browse the catalog of available wedding-website themes

No parameter schema in public metadata yet.

update_current_themeSwitch the wedding website to a different theme template

Switch the wedding website to a different theme template

No parameter schema in public metadata yet.

update_website_customizationUpdate website colors and fonts

Update website colors and fonts

No parameter schema in public metadata yet.

list_card_projectsList your invitation / save-the-date / shower-invite card projects (paper or digital)

List your invitation / save-the-date / shower-invite card projects (paper or digital)

No parameter schema in public metadata yet.

get_card_projectGet full details for one invitation project including all customizations

Get full details for one invitation project including all customizations

No parameter schema in public metadata yet.

validate_card_projectValidate an invitation project — reports any text-fit, image, or guest-addressing errors per customization

Validate an invitation project — reports any text-fit, image, or guest-addressing errors per customization

No parameter schema in public metadata yet.

get_card_project_guestsList the guest groups assigned to an invitation project, including per-group font-size overrides

List the guest groups assigned to an invitation project, including per-group font-size overrides

No parameter schema in public metadata yet.

get_card_suiteGet details for an invitation design suite, including paper types, sizes, and price range

Get details for an invitation design suite, including paper types, sizes, and price range

No parameter schema in public metadata yet.

search_card_catalogSearch the invitation design catalog

Search the invitation design catalog

No parameter schema in public metadata yet.

list_favorite_card_suitesList invitation design suites you have favorited (hearted)

List invitation design suites you have favorited (hearted)

No parameter schema in public metadata yet.

get_rsvp_pageGet the RSVP page settings on the wedding website

Get the RSVP page settings on the wedding website

No parameter schema in public metadata yet.

create_card_projectCreate a new invitation project from a design suite and a lead variation

Create a new invitation project from a design suite and a lead variation

No parameter schema in public metadata yet.

swap_card_project_variationSwap one or more customizations on a project to different variations

Swap one or more customizations on a project to different variations

No parameter schema in public metadata yet.

set_card_project_guestsEnable / disable guest groups for an invitation project and optionally override font sizes

Enable / disable guest groups for an invitation project and optionally override font sizes

No parameter schema in public metadata yet.

preview_card_templateRender an invitation template preview with text substituted in

Render an invitation template preview with text substituted in

No parameter schema in public metadata yet.

preview_qrcodeGenerate a QR-code PNG for an invitation

Generate a QR-code PNG for an invitation

No parameter schema in public metadata yet.

set_card_project_qrcodePlace (or update) a QR code on a specific page of an invitation project

Place (or update) a QR code on a specific page of an invitation project

No parameter schema in public metadata yet.

zola_healthcheckVerify the credential and Zola reachability; says which hop failed

Verify the credential and Zola reachability; says which hop failed

No parameter schema in public metadata yet.

get_wedding_dashboardPlanning dashboard overview

Planning dashboard overview

No parameter schema in public metadata yet.

search_storefrontsSearch marketplace by category/location

Search marketplace by category/location

No parameter schema in public metadata yet.

get_storefrontFull vendor storefront details

Full vendor storefront details

No parameter schema in public metadata yet.

list_favoritesFavorited vendors

Favorited vendors

No parameter schema in public metadata yet.

Sponsors

Configuration

ZOLA_REFRESH_TOKENsecret

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

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

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

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

Overrides the account id normally read from GET /v3/users/me/context. Set it only to pin a specific account.

ZOLA_REGISTRY_ID

Overrides the registry id normally read from the same context call.

ZOLA_WEDDING_ID

Overrides the wedding id normally read from the same context call.

ZOLA_SESSION_TOKENsecret

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

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

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

Absolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

Readme

Zola MCP

CI npm license

A Model Context Protocol server that connects Claude to Zola, giving you natural-language access to your wedding vendors, budget, guest list, seating chart, events, registry, inquiries, and more.

[!WARNING] AI-developed project. This codebase was entirely built and is actively maintained by Claude Code. No human has audited the implementation. Review all code and tool permissions before use.

What you can do

Ask Claude things like:

  • "How's wedding planning going?"
  • "Find a photographer in Charlotte, NC"
  • "Update the venue cost to $25,000"
  • "Who hasn't RSVP'd yet?"
  • "Seat Pat at Table 1"
  • "Any new vendor messages?"
  • "Add my cousin Mike to the guest list"
  • "Show me the gift tracker"

Requirements


View the full README on GitHub

Details

Repository
github.com/chrischall/zola-mcp
Package
zola-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from chrischall