Skip to content
MCP server

Honeybook MCP

MCP server that reads vendor contracts, invoices and messages in HoneyBook client portals

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
1.4.0
Listing updated
today

Similar MCP servers

About Honeybook MCP

Honeybook MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Written for people booking vendors such as wedding planners and photographers, this server lets an assistant read what those vendors sent through HoneyBook's client portal: unsigned contracts, invoices due, payments made, checklists, meetings and message threads. It can also reply to messages.

HoneyBook has no public client-portal API, so the server reuses the session your own browser has after you click a vendor's magic link. The ContextMint Bridge Chrome extension snapshots that session when you call use_magic_link, and sessions are saved to ~/.honeybook-mcp/sessions.json. A separate use_flow_link and get_flow pair handles questionnaire links, with credentials kept in a different file.

The README warns that HoneyBook's terms prohibit scraping, that it calls internal endpoints which may change, and that the code was built by Claude Code with no human audit.

Install

Run in a terminal

claude mcp add honeybook-mcp -- npx -y honeybook-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "honeybook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "honeybook-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "honeybook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "honeybook-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "honeybook-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "honeybook-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "honeybook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "honeybook-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "honeybook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "honeybook-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • HONEYBOOK_API_VERSIONPin 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_FETCHPROXYSet 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_DIRBase directory holding sessions.json and flows.json (the captured portal sessions and questionnaire credentials). Defaults to ~/.honeybook-mcp.
  • FETCHPROXY_WS_PORTLocalhost 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_HOSTBind 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_DIRAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

use_magic_link
Captures a vendor portal session from a magic-link tab.
use_flow_link
Captures a questionnaire flow credential.
get_flow
Reads one questionnaire.
list_active_sessions
Lists active portal sessions and flow credentials.

What it does

Contract and invoice lookup
Lists unsigned contracts and invoices coming due.
Payment overview
Shows what has been paid and what is still owed.
Vendor messaging
Reads and replies to vendor messages.
Meeting details
Finds the next call and its link.
Questionnaire links
Reads single questionnaire flows from flow links.
Per-vendor sessions
Keeps sessions for each vendor portal.

Good for

  • List every unsigned vendor contract
  • See invoices due in the next month
  • Summarise a planner's contract
  • Reply to a vendor about timing
  • Check what you have paid so far

Pricing

Open source

Honeybook MCP FAQ

Does HoneyBook have an API for this?

No; the README says there is no public client-portal API, so the server reuses your signed-in browser session.

What do I need installed?

Node.js 22 or later, the ContextMint Bridge extension in Chrome, and a magic-link email from a vendor.

Is it allowed by HoneyBook?

The README notes HoneyBook's terms broadly prohibit scraping and that no exception has been granted; use is at your own risk.

Where are sessions stored?

In memory and in ~/.honeybook-mcp/sessions.json with mode 0600.

Is Honeybook MCP free?

Yes. Honeybook MCP is open source, so you can use and self-host it for free.

How do I add Honeybook MCP to Claude Code?

Run this command in your terminal: claude mcp add honeybook-mcp -- npx -y honeybook-mcp

What are the best alternatives to Honeybook MCP?

The closest alternatives to Honeybook MCP are Ha MCP, Concord MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and Budget Tracker.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers