@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