chrischall

honeybook-mcp

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.

chrischall 1 Updated 1mo ago

Resources

21
GitHub

Install

npx skillscat add chrischall/honeybook-mcp

Install via the SkillsCat registry.

SKILL.md

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.

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

Categories

Processing Git & VCS
GitHub

Install

npx skillscat add chrischall/honeybook-mcp

Install via the SkillsCat registry.

Recommended Skills