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