How to Use the HighLevel MCP in Claude Code

Q: How do I use Claude Code to create a new contact in HighLevel from the terminal?

You pass a JSON string to the createcontact tool. For example: claude mcp call highlevel-mcp createcontact --bodyjson '{"firstName": "Jane", "email": "jane@example.com"}'. It's all done in one command.

Q: Can I pipe data between HighLevel tools using Claude Code?

Absolutely. You can find a contact ID using searchcontacts and jq, then pipe that ID to getcontactdetails to fetch their full record. It’s designed for standard shell scripting.

Q: How can I check my calendar availability in HighLevel with Claude Code?

Use the getcalendarfreeslots tool with a calendar ID and a date range. It will return a JSON array of available slots, which you can then parse or view directly in your terminal.

Automate HighLevel from your terminal. Pipe CRM data, run cron jobs, and manage your pipeline with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HighLevel MCP to Claude Code

Create your Vinkius account to connect HighLevel to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HighLevel with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run CRM Automation in CI/CD

Connect Claude Code to this MCP Server and you can run HighLevel operations in any headless environment. Set up a GitHub Action that runs nightly to check for stale opportunities using `search_opportunities`. Then, have it assign a follow-up task with `create_contact_task`. Because Claude Code is just a command-line tool, it fits right into your existing DevOps workflows. Pipe the output of one tool, like `search_contacts`, directly into another script for processing. No GUI needed.

Script and Schedule Your Workflow

Write simple shell scripts to interact with your CRM. You could have a script that checks your calendar availability every morning using `get_calendar_free_slots` and pings you on Slack if you have unexpected free time. Combine tools to build powerful one-liners. For instance, find a contact ID with `search_contacts` and pipe it directly into a command that uses `list_contact_tasks` to see what's on their plate. It's fast, scriptable, and lives where you work.

Headless HighLevel MCP Server Access

This server exposes 11 tools for managing HighLevel, from `create_contact` to `list_pipelines`. Claude Code connects over a simple HTTP transport, authenticates with your token, and gives you direct command-line access to each tool. The output is clean JSON, so you can easily parse it with `jq` or any other terminal utility. It's built for developers who need reliable, programmatic access to their marketing and sales data without ever leaving the terminal.

Setup guide

Set up HighLevel MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see highlevel-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest HighLevel transactions." It will automatically discover and invoke the available HighLevel tools.

Terminal

claude mcp add --transport http highlevel-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the HighLevel MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "highlevel-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HighLevel. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HighLevel now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HighLevel MCP in Claude Code

You pass a JSON string to the `create_contact` tool. For example: `claude mcp call highlevel-mcp create_contact --body_json '{"firstName": "Jane", "email": "jane@example.com"}'`. It's all done in one command.

Absolutely. You can find a contact ID using `search_contacts` and `jq`, then pipe that ID to `get_contact_details` to fetch their full record. It’s designed for standard shell scripting.

You could set up a cron job to run a script every hour. The script could use `search_opportunities` to find deals that have just closed and then automatically add a 'customer-onboard' tag to the associated contact.

Use the `get_calendar_free_slots` tool with a calendar ID and a date range. It will return a JSON array of available slots, which you can then parse or view directly in your terminal.

When your script calls the HighLevel tools, it sends requests for contact, calendar, or pipeline data to the MCP Server. The connection is authenticated via your personal token, and the server runs in a zero-trust, isolated container that's torn down after execution. Your data is only ever in transit.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript