# GoHighLevel MCP Server

A Model Context Protocol (MCP) server that connects Claude to GoHighLevel's CRM platform.

## Features

- **14 Tools** across 4 domains:
  - Contact Management (5 tools)
  - Messaging & Conversations (4 tools)
  - Calendar & Appointments (3 tools)
  - Sales Opportunities (4 tools)

## Installation

```bash
git clone https://github.com/YOUR_USERNAME/gohighlevel-mcp-server.git
cd gohighlevel-mcp-server
npm install
```

## Setup

1. Get your GHL API token from GoHighLevel
2. Set the environment variable:
```bash
export GHL_API_TOKEN="your-api-token-here"
```

3. Start the server:
```bash
npm start
```

## Usage with Claude Desktop

Add to `~/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "gohighlevel": {
      "command": "bash",
      "args": ["-c", "cd ~/projects/gohighlevel-mcp-server && export GHL_API_TOKEN='YOUR_TOKEN' && npm start"]
    }
  }
}
```

Then restart Claude Desktop.

## API Reference

- **Search Contacts** - Search for contacts by query
- **Get Contact** - Retrieve a specific contact
- **Create Contact** - Add a new contact
- **Update Contact** - Modify contact details
- **Add Tags** - Assign tags to contacts
- **List Conversations** - View contact conversations
- **Get Conversation** - Retrieve conversation details
- **Send SMS** - Send SMS messages
- **Send Email** - Send email messages
- **List Appointments** - View calendar appointments
- **Get Appointment** - Retrieve appointment details
- **Create Appointment** - Schedule new appointments
- **List Opportunities** - View sales opportunities
- **Get Opportunity** - Retrieve opportunity details
- **Create Opportunity** - Add new sales opportunities
- **Update Opportunity** - Modify opportunity status/value

## Development

Built with:
- TypeScript with strict mode
- Zod for runtime validation
- Axios for HTTP requests
- MCP SDK for protocol implementation

## License

MIT