chrischall avatar

Honeybook Mcp

chrischall/honeybook-mcp

Connects Claude to HoneyBook client portals through browser session capture using the fetchproxy extension. Once authenticated via a vendor's magic link, you can list contracts and invoices, filter by status or due date, pull full file details, and generate deep links to sign or pay directly in the portal. Built for wedding clients juggling multiple vendor portals. The server calls internal HoneyBook endpoints without official API support, so it's subject to breakage and HoneyBook's terms explicitly prohibit scraping. Sessions persist locally in ~/.honeybook-mcp/sessions.json. Destructive actions like signing contracts require confirmation flags and only return portal URLs rather than executing headlessly.

GitHub stars
1
tools
21
transport
STDIO
env vars
6
last updated
Nov 11, 2026

Tools

21 tools

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

use_magic_linkCapture a session from a magic-link URL

Capture a session from a magic-link URL

No parameter schema in public metadata yet.

list_active_sessionsShow active credentials, split by kind

Show active credentials, split by kind

No parameter schema in public metadata yet.

use_flow_linkCapture a questionnaire (flow) credential

Capture a questionnaire (flow) credential

No parameter schema in public metadata yet.

get_flowRead one questionnaire and its answers

Read one questionnaire and its answers

No parameter schema in public metadata yet.

list_workspace_filesFiles from one vendor; filter by type

Files from one vendor; filter by type

No parameter schema in public metadata yet.

get_workspace_fileFull detail for one file

Full detail for one file

No parameter schema in public metadata yet.

get_workspaceWorkspace detail + status flags

Workspace detail + status flags

No parameter schema in public metadata yet.

list_payment_methodsSaved payment methods (brand, last 4, expiry)

Saved payment methods (brand, last 4, expiry)

No parameter schema in public metadata yet.

sign_contractDeep link to sign in portal (after you confirm)

Deep link to sign in portal (after you confirm)

No parameter schema in public metadata yet.

pay_invoiceDeep link to pay in portal (after you confirm)

Deep link to pay in portal (after you confirm)

No parameter schema in public metadata yet.

list_projectsYour projects with a vendor + their workspace ids

Your projects with a vendor + their workspace ids

No parameter schema in public metadata yet.

get_projectProject details: date, location, people, custom fields

Project details: date, location, people, custom fields

No parameter schema in public metadata yet.

list_messagesMessages (or the activity log) in a workspace, newest first

Messages (or the activity log) in a workspace, newest first

No parameter schema in public metadata yet.

get_messageOne message in full: body, attachments, delivery status

One message in full: body, attachments, delivery status

No parameter schema in public metadata yet.

send_messageSend or reply through the portal (after you confirm)

Send or reply through the portal (after you confirm)

No parameter schema in public metadata yet.

mark_messages_seenMark feed items seen (reads never do this on their own)

Mark feed items seen (reads never do this on their own)

No parameter schema in public metadata yet.

list_meetingsScheduled meetings with join links, latest time wins

Scheduled meetings with join links, latest time wins

No parameter schema in public metadata yet.

list_tasksTasks the vendor assigned you, with counts

Tasks the vendor assigned you, with counts

No parameter schema in public metadata yet.

list_notesNotes the vendor shared

Notes the vendor shared

No parameter schema in public metadata yet.

list_attachmentsLoose images, files and bookmarks in a workspace

Loose images, files and bookmarks in a workspace

No parameter schema in public metadata yet.

list_paymentsPayment schedule with paid/unpaid totals

Payment schedule with paid/unpaid totals

No parameter schema in public metadata yet.

Sponsors

Configuration

HONEYBOOK_API_VERSION

Pin the hb-api-client-version header (a positive integer, e.g. 2601) instead of auto-fetching it from /api/gon. Leave unset normally — a pinned value can go stale and HoneyBook then answers 400.

HONEYBOOK_DISABLE_FETCHPROXY

Set to 1/true to refuse to call the fetchproxy bootstrap (CI / headless). use_magic_link and use_flow_link then fail instead of capturing a credential. Defaults to false.

HONEYBOOK_SESSIONS_DIR

Base directory holding sessions.json and flows.json (the captured portal sessions and questionnaire credentials). Defaults to ~/.honeybook-mcp.

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

HoneyBook MCP

CI npm license

A Model Context Protocol server that connects Claude to the HoneyBook client portal, giving you natural-language access to contracts and invoices sent by your wedding vendors.

[!WARNING] AI-developed project. This codebase was 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:


View the full README on GitHub

Details

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

More from chrischall