SolidInvoice
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
Zola wedding planning for Claude — vendors, budget, guests, seating, registry, and RSVPs
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 25/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 37/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: 70 (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Zola MCP. Follow https://mcp.popnx.com/i/chrischall-zola-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Zola MCP for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "zola": { "command": "npx", "args": [ "-y", "zola-mcp" ], "env": { "ZOLA_SESSION_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For ZOLA_SESSION_TOKEN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Zola MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
SettingsDeveloperEdit Config
{
"mcpServers": {
"zola": {
"command": "npx",
"args": [
"-y",
"zola-mcp"
],
"env": {
"ZOLA_SESSION_TOKEN": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Zola MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Zola MCP or shows a Zola MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
ZOLA_REFRESH_TOKEN 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…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…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.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/).Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Zola MCP yet
Zola MCP runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Zola MCP
B · Others in Accounting, finance & tax that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a Zola MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Zola MCP for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user zola --env ZOLA_SESSION_TOKEN=your-value -- npx -y zola-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For ZOLA_SESSION_TOKEN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Zola MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user zola --env ZOLA_SESSION_TOKEN=your-value -- npx -y zola-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Zola MCP listed as connected
Use Zola MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Zola MCP or shows a Zola MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
ZOLA_REFRESH_TOKEN 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…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…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.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/).Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Zola MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Zola MCP for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "zola": { "command": "npx", "args": [ "-y", "zola-mcp" ], "env": { "ZOLA_SESSION_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For ZOLA_SESSION_TOKEN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Zola MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Zola MCP settings, ZOLA_SESSION_TOKEN is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Zola MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Zola MCP or shows a Zola MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
ZOLA_REFRESH_TOKEN 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…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…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.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/).Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Zola MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Zola MCP for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "zola": { "type": "stdio", "command": "npx", "args": [ "-y", "zola-mcp" ], "env": { "ZOLA_SESSION_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For ZOLA_SESSION_TOKEN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Zola MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Zola MCP settings, ZOLA_SESSION_TOKEN is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Zola MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Zola MCP or shows a Zola MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
ZOLA_REFRESH_TOKEN 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…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…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.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/).Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user zola --env ZOLA_SESSION_TOKEN=your-value -- npx -y zola-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"zola": {
"command": "npx",
"args": [
"-y",
"zola-mcp"
],
"env": {
"ZOLA_SESSION_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"zola": {
"command": "npx",
"args": [
"-y",
"zola-mcp"
],
"env": {
"ZOLA_SESSION_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"zola": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"zola-mcp"
],
"env": {
"ZOLA_SESSION_TOKEN": "your-value"
}
}
}
}ZOLA_REFRESH_TOKEN secret envZOLA_DISABLE_FETCHPROXY envZOLA_TOKEN_CACHE secret envZOLA_TOKEN_FILE envZOLA_ACCOUNT_ID envZOLA_REGISTRY_ID envZOLA_WEDDING_ID envZOLA_SESSION_TOKEN secret required envFETCHPROXY_WS_PORT envFETCHPROXY_WS_HOST envFETCHPROXY_IDENTITY_DIR envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account chrischall, which owns the repo
Code last changed 3 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for zola-mcp@2.2.2
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/chrischall-zola-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: ZOLA_SESSION_TOKEN
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 3 days ago, and the latest version (2.2.2) reached the registry 12 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.
Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.
48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
| This one Zola MCP | SolidInvoice | Signal8 | Journalit | Beancount.io | Tapetide - Indian Stock Market MCP | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Cloud or install on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer |
| Needs a key | Yes | No | Yes | No | No | Yes |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 4/6 | 5/5 | 4/4 | 4/4 | 5/5 |
| License | MIT | MIT | MIT | NOASSERTION | MIT | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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.
Ask Claude things like:
By using this MCP server, you acknowledge and agree to the following:
1. This server accesses your own Zola account. Auth happens via your own credentials. It does not — and cannot — access anyone else's wedding website, registry, or guest list.
2. [Zola's Terms of Use](https://www.zola.com/terms) govern your use of this server, just as they govern your direct use of zola.com. The clauses most relevant here:
[You may not use] any hardware or software intended to surreptitiously intercept or otherwise obtain any information… including but not limited to the use of any "scraping" or other data mining techniques, robots or similar data gathering and extraction tools.
And, critically, on agent-acting-as-you: *"You are responsible for maintaining the confidentiality of your account and password… You accept full responsibility for all activities that occur under your account and password, even if such actions are undertaken by your Authorized Agent or other third party."*
You are agreeing to those terms — read by the maintainer 2026-05-23 — every time you invoke a tool in this server. Zola's ToU is explicit: this MCP acting as your Authorized Agent counts as you.
3. Personal, non-commercial use only. This project is not affiliated with, endorsed by, sponsored by, or in partnership with Zola, Inc. It is a personal automation tool for one couple to manage their own wedding website, registry, vendor research, and guest list. Do not use it to bulk-extract Zola's vendor directory, scrape registries, or compete with Zola.
4. Stability is not guaranteed. This server may call internal Zola endpoints that change without notice. It may break.
5. You accept full responsibility for any consequences of using this server in connection with your Zola account — rate limiting, account warnings, suspension, or any enforcement action. Per Zola's ToU, anything this MCP does under your account is your action — review guest list edits, registry changes, and inquiries before confirming. If Zola objects to your use, stop using this server.
This section is the maintainer's good-faith summary of the terms — it is not legal advice and does not modify or supersede Zola's actual ToU.
Download the latest .mcpb bundle from Releases and install:
claude mcp add-from-mcpb zola-mcp-x.y.z.mcpb
You'll be prompted for your ZOLA_REFRESH_TOKEN (see Getting your refresh token below).
npx -y zola-mcp
Add to your Claude config (.mcp.json or Claude Desktop config):
{
"mcpServers": { "zola": { "command": "npx", "args": ["-y", "zola-mcp"], "env": { "ZOLA_REFRESH_TOKEN": "your-refresh-token-jwt" } } } }
git clone https://github.com/chrischall/zola-mcp.git
cd zola-mcp npm install npm run build
Add to Claude Desktop config:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": { "zola": { "command": "node", "args": ["/absolute/path/to/zola-mcp/dist/bundle.js"], "env": { "ZOLA_REFRESH_TOKEN": "your-refresh-token-jwt" } } } }
You have two options. Both produce the same usr cookie value — a ~1-year JWT that doubles as the refresh token.
chrome://extensions (Developer mode on). Safari is not available yet (it will ship inside the ContextMint app, which has no public download), so use Chrome for now.ContextMint Bridge is the fetchproxy browser extension under its new name, from the same maintainer — fetchproxy's own README (fetchproxy#extension) points to it. Its source is public at nullnet-app/contextmint-bridge: build it yourself, or check a release zip against the .sha256 file published beside it (shasum -a 256 -c contextmint-bridge-chrome- .zip.sha256).
ZOLA_REFRESH_TOKEN unset in your Claude config.On the first tool call, the MCP asks the extension for the HttpOnly usr cookie via chrome.cookies.get, then operates direct-to-API from Node — the bridge is never in the hot path.
That cookie is the ~1-year refresh token, so it is cached at $MCP_DATA_DIR/.zola-mcp/refresh-token.json (falling back to $HOME, mode 0600). Later starts read it from there and need no browser at all, which is what makes the server usable on a remote host where none exists. If the API ever rejects the cached token — you signed out, or it aged past its year — it is discarded automatically and the extension is asked again. To re-auth, just sign back in to zola.com. Set ZOLA_TOKEN_CACHE=false to keep nothing on disk and ask the browser every time.
You can opt out of this fallback with ZOLA_DISABLE_FETCHPROXY=1 (e.g. in headless / CI environments where no extension is available).
https://www.zola.com.usr cookie..env as ZOLA_REFRESH_TOKEN= (or into your Claude config env block).Quit completely (Cmd+Q on Mac) and relaunch.
Ask Claude: *"How's wedding planning going?"* — it should show your wedding dashboard.
| Env var | Required | Notes |
|---|---|---|
ZOLA_REFRESH_TOKEN | Conditional | Refresh token JWT (~1 year lifetime). When unset, the MCP falls back to the ContextMint Bridge browser extension to read the usr cookie from your signed-in zola.com tab. |
ZOLA_DISABLE_FETCHPROXY | No | Set to 1 to opt out of the fetchproxy fallback (headless / CI). Does not disable the token cache — a headless run can still reuse a token an earlier bootstrap cached, since reading a file is not opening a browser. |
ZOLA_TOKEN_CACHE | No | Set to false to disable the on-disk refresh-token cache and ask the browser on every start. Defaults to enabled, and is inert when ZOLA_REFRESH_TOKEN is set. |
ZOLA_TOKEN_FILE | No | Absolute path for the cache file. Defaults to $MCP_DATA_DIR/.zola-mcp/refresh-token.json, else $HOME/.zola-mcp/refresh-token.json. |
ZOLA_ACCOUNT_ID | No | Auto-resolved from API on first use |
ZOLA_REGISTRY_ID | No | Auto-resolved from API on first use |
MCP_CONFIRM_MODE | No | Default ask-user. What a confirmed write does on a client that cannot show a confirmation prompt (claude.ai, Claude Desktop). ask-user: two steps — the first call writes nothing and returns a preview plus a token, and the model must get your approval in chat before calling again with it. auto: the same two steps, but the model may use the token after reviewing the preview itself. refuse: those writes are refused on such clients. A client that can show prompts (Claude Code) always gets the real prompt, unless MCP_CONFIRM_ELICITATION=off. An unrecognised value is treated as refuse. |
MCP_CONFIRM_ELICITATION | No | Default on. off never sends a confirmation prompt, so every client gets the MCP_CONFIRM_MODE path. Set it for a client that declares it can show prompts but never does (the gated call hangs — opencode 2.0.x). Any other value stays on, with a stderr warning. |
MCP_CONFIRM_TTL_SECONDS | No | Default 600. How long a confirm token stays valid. |
MCP_CONFIRM_SECRET | No | Signing key for confirm tokens (default: random per process). Set it only if tokens must survive a server restart. |
77 tools across 12 areas. The Permission column says what stands between a call and a change:
The server-gated writes are remove_guest, update_event, update_wedding_settings, remove_faq, remove_home_section, remove_poi, remove_travel_item, remove_registry_item, set_event_guests and remove_event_invitation (set_event_guests only when it uninvites anyone). Each first shows a preview naming the household, event, item or page content and exactly what changes (for a slug change, the old and new website URL; a registry item on a private or passcode-gated registry, or outside the default collection, is shown by id because only the public page names it), then proceeds only once you approve — see MCP_CONFIRM_MODE above.
| Tool | What it does | Permission |
|---|---|---|
list_vendors | List all booked vendors | Auto |
search_vendors | Search vendors by name/category | Auto |
add_vendor | Book a new vendor | Host prompt |
update_vendor | Update vendor details | Host prompt |
remove_vendor | Unbook a vendor | Host prompt |
| Tool | What it does | Permission |
|---|---|---|
get_budget | Budget summary with all items | Auto |
update_budget_item | Update cost or note | Host prompt |
| Tool | What it does | Permission |
|---|---|---|
list_guests | List all guest groups with stats — names, tier and RSVP state by default; view: "full" adds addresses, emails and phones | Auto |
add_guest | Add a guest group | Host prompt |
update_guest_address | Update mailing address | Host prompt |
remove_guest | Remove a guest group (with its RSVPs and seats) | Server gate |
| Tool | W