Tmp.ZYr9sBY5Dv

This skill should be used when the user asks about HoneyBook client-portal data. Triggers on phrases like "check HoneyBook", "sign contract", "pay invoice", "HoneyBook vendors", "unsigned contracts", "open invoices", or any request involving wedding-vendor contracts, invoices, brochures, proposals, or payments via HoneyBook.

honeybook-mcp

MCP server for HoneyBook's client portal — 8 tools for viewing contracts and invoices across multiple wedding vendors, with magic-link session capture and deep-link fallback for signing and paying.

• Source: github.com/chrischall/honeybook-mcp

Setup

Option A — Claude Code

Add to .mcp.json:

{
  "mcpServers": {
    "honeybook": {
      "command": "node",
      "args": ["/absolute/path/to/honeybook-mcp/dist/bundle.js"]
    }
  }
}

No env vars required. Activate a session by calling use_magic_link in Claude.

Option B — from source

git clone https://github.com/chrischall/honeybook-mcp
cd honeybook-mcp && npm install && npm run build

Tools

Tool	What it does
use_magic_link	Capture a session from a vendor magic-link URL
list_active_sessions	Show currently active portal sessions
list_workspace_files	All files one vendor has shared (filter by type)
get_workspace_file	Full detail for one file
get_workspace	Workspace detail + status flags
list_payment_methods	Saved payment methods
sign_contract	Deep link to sign in portal (requires confirm:true)
pay_invoice	Deep link to pay in portal (requires confirm:true)

Workflows

• First time with a vendor → user pastes magic-link URL → use_magic_link → session captured
• "What contracts haven't I signed?" → list_workspace_files with file_type=agreement, filter by is_file_accepted=false
• "Summarize my HB status with Silk Veil" → get_workspace (status flags) + list_workspace_files
• "Send me a link to sign the photographer's contract" → list_workspace_files → sign_contract with confirm:true
• "Which invoices are overdue?" → list_workspace_files with file_type=invoice, sort by due date

Notes

• All tools hit api.honeybook.com/api/v2/* with 8 custom hb-api-* headers
• Sessions are captured via Puppeteer from magic-link URLs and cached in ~/.honeybook-mcp/sessions.json (mode 0600)
• Each vendor = separate session keyed by portal origin
• sign_contract / pay_invoice return deep links — actual signing/paying requires browser-side device/SCA handling
• Session expires → re-run use_magic_link with a fresh URL from the vendor's email