# Honeybook MCP

> Honeybook MCP is an open-source MCP server for productivity. MCP server that reads vendor contracts, invoices and messages in HoneyBook client portals. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/chrischall/honeybook-mcp
- **MCP Registry name:** io.github.chrischall/honeybook-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add honeybook-mcp -- npx -y honeybook-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/honeybook-mcp
