@honecrm/mcp-server

MCP (Model Context Protocol) server for Hone CRM. Enables AI agents and LLM clients (Claude, GPT, etc.) to interact with your CRM data through a standardized tool interface.

Quick start

Run directly with npx — no install required:

HONECRM_API_KEY=hone_xxxx npx @honecrm/mcp-server

Or install globally:

npm install -g @honecrm/mcp-server
HONECRM_API_KEY=hone_xxxx honecrm-mcp

Client configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "honecrm": {
      "command": "npx",
      "args": ["@honecrm/mcp-server"],
      "env": {
        "HONECRM_API_KEY": "hone_xxxx"
      }
    }
  }
}

Claude Code

claude mcp add honecrm -- npx @honecrm/mcp-server

Then set the environment variable in your shell or .env:

export HONECRM_API_KEY=hone_xxxx

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "honecrm": {
      "command": "npx",
      "args": ["@honecrm/mcp-server"],
      "env": {
        "HONECRM_API_KEY": "hone_xxxx"
      }
    }
  }
}

Environment variables

Variable	Required	Default	Description
`HONECRM_API_KEY`	Yes	—	Your Hone CRM API key
`HONECRM_BASE_URL`	No	`https://api.honecrm.com/v1`	API base URL

Available tools

Deals

Tool	Description
`list_deals`	List deals with optional filters (stage, status, search, teamId)
`get_deal`	Get a single deal by ID
`create_deal`	Create a new deal with name, value, contact, and stage
`update_deal`	Update an existing deal's fields
`delete_deal`	Delete a deal by ID

Contacts

Tool	Description
`list_contacts`	List contacts with optional filters (search, companyId, teamId)
`get_contact`	Get a single contact by ID
`create_contact`	Create a new contact with name, email, and optional fields

Companies

Tool	Description
`list_companies`	List companies with optional filters (search, industry, domain)
`get_company`	Get a single company by ID
`create_company`	Create a new company with name and optional fields

Search

Tool	Description
`search`	Full-text search across deals, contacts, companies, and notes

Protocol

Transport: JSON-RPC over stdio
Protocol version: 2024-11-05
Authentication: API key via environment variable (passed to Hone CRM REST API)

How it works

The MCP server acts as a bridge between LLM clients and the Hone CRM API:

LLM Client  ←→  MCP Server (stdio)  ←→  Hone CRM REST API
(Claude)         @honecrm/mcp-server      api.honecrm.com

All data access goes through the @honecrm/sdk HTTP client — the MCP server never accesses the database directly. API key scopes and rate limits are enforced server-side.

Requirements

Node.js >= 18

License

MIT