# cryptojym/gohighlevel-mcp architecture

> Architecture diagram of the GitHub repository cryptojym/gohighlevel-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cryptojym/gohighlevel-mcp
- Repository: https://github.com/cryptojym/gohighlevel-mcp

## Overview

This is a GoHighLevel MCP client with two access modes: a JavaScript/CLI and optional REST API client, plus a stdio MCP proxy for AI-tool hosts. Users configure a Private Integration Token and location, then send CRM operations through the client or proxy to GoHighLevel’s official MCP service. The README documents contacts, conversations, calendars, opportunities, payments, locations, and tool discovery; some domain methods are in unsampled portions of index.js, so those capabilities are represented without asserting unseen internal call paths.

Main entry points: [`index.js`](https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js) (GHL Client), [`cli.js`](https://github.com/cryptojym/gohighlevel-mcp/blob/main/cli.js) (Command Line), [`gohighlevel-mcp-proxy.mjs`](https://github.com/cryptojym/gohighlevel-mcp/blob/main/gohighlevel-mcp-proxy.mjs) (Stdio Proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access Interfaces"]
  node_cli["Command Line<br/>[cli.js]"]
  node_http_api["REST API<br/>[index.js]"]
  node_stdio_proxy["Stdio Proxy"]
end

subgraph group_client["Client Operations"]
  node_client["GHL Client<br/>[index.js]"]
  node_contacts["Contact Management<br/>[index.js]"]
  node_conversations["Conversation Management<br/>[index.js]"]
  node_calendars["Calendar Management<br/>[index.js]"]
  node_opportunities["Opportunity Management<br/>[index.js]"]
  node_payments["Payment Management<br/>[index.js]"]
  node_location_tools["Location And Tools<br/>[index.js]"]
end

subgraph group_services["Remote Services"]
  node_ghl_mcp["Official GHL MCP"]
end

node_cli_user(("CLI User"))
node_http_caller(("HTTP Caller"))
node_mcp_host(("MCP Host"))

node_cli_user -->|"runs commands"| node_cli
node_cli -->|"dispatches commands"| node_client
node_http_caller -->|"sends requests"| node_http_api
node_http_api -->|"calls methods"| node_client
node_mcp_host -->|"starts proxy"| node_stdio_proxy
node_stdio_proxy -->|"proxies MCP"| node_ghl_mcp
node_client -->|"sends API requests"| node_ghl_mcp
node_client -->|"provides operations"| node_contacts
node_client -->|"provides operations"| node_conversations
node_client -->|"provides operations"| node_calendars
node_client -->|"provides operations"| node_opportunities
node_client -->|"provides operations"| node_payments
node_client -->|"provides operations"| node_location_tools

click node_cli "https://github.com/cryptojym/gohighlevel-mcp/blob/main/cli.js"
click node_http_api "https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js"
click node_stdio_proxy "https://github.com/cryptojym/gohighlevel-mcp/blob/main/gohighlevel-mcp-proxy.mjs"
click node_client "https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js"
click node_contacts "https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js"
click node_conversations "https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js"
click node_calendars "https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js"
click node_opportunities "https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js"
click node_payments "https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js"
click node_location_tools "https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_http_api,node_stdio_proxy,node_cli_user toneBlue
class node_client,node_contacts,node_conversations,node_calendars,node_opportunities,node_payments,node_location_tools toneAmber
class node_ghl_mcp toneMint
class node_http_caller,node_mcp_host toneIndigo
```

## Components

### Access Interfaces

- [Command Line](https://github.com/cryptojym/gohighlevel-mcp/blob/main/cli.js): `cli.js`
- [REST API](https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js): `index.js`
- [Stdio Proxy](https://github.com/cryptojym/gohighlevel-mcp/blob/main/gohighlevel-mcp-proxy.mjs): `gohighlevel-mcp-proxy.mjs`

### Client Operations

- [GHL Client](https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js): `index.js`
- [Contact Management](https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js): `index.js`
- [Conversation Management](https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js): `index.js`
- [Calendar Management](https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js): `index.js`
- [Opportunity Management](https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js): `index.js`
- [Payment Management](https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js): `index.js`
- [Location And Tools](https://github.com/cryptojym/gohighlevel-mcp/blob/main/index.js): `index.js`

### Remote Services

- **Official GHL MCP**

### Other components

- **CLI User**
- **HTTP Caller**
- **MCP Host**

## Connections

- CLI User → Command Line: runs commands (evidence: `cli.js`)
- Command Line → GHL Client: dispatches commands (evidence: `cli.js`)
- HTTP Caller → REST API: sends requests (evidence: `README.md`)
- REST API → GHL Client: calls methods (evidence: `index.js`)
- MCP Host → Stdio Proxy: starts proxy (evidence: `README.md`)
- Stdio Proxy → Official GHL MCP: proxies MCP (evidence: `gohighlevel-mcp-proxy.mjs`)
- GHL Client → Official GHL MCP: sends API requests (evidence: `index.js`)
- GHL Client → Contact Management: provides operations (evidence: `README.md`)
- GHL Client → Conversation Management: provides operations (evidence: `README.md`)
- GHL Client → Calendar Management: provides operations (evidence: `README.md`)
- GHL Client → Opportunity Management: provides operations (evidence: `README.md`)
- GHL Client → Payment Management: provides operations (evidence: `README.md`)
- GHL Client → Location And Tools: provides operations (evidence: `README.md`)
