How to integrate Highlevel MCP with Codex

Connect Codex to Highlevel MCP. List new highlevel leads by pipeline, draft sms follow-ups for missed appointments, and more using natural language, with authentication handled for you.

Highlevel logoHighlevel
Oauth2

Highlevel is a marketing automation and CRM platform for agencies, with funnels, scheduling, two-way texting, and client pipeline tools. It helps teams manage leads, conversations, bookings, and follow-ups from one place.

94 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Highlevel MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate Highlevel with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Highlevel MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

What is the Highlevel MCP server, and what's possible with it?

The Highlevel MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Highlevel account. It provides structured and secure access so your agent can perform Highlevel operations on your behalf.

Conclusion

You've successfully integrated Highlevel with Codex using Composio's MCP server. Now you can interact with Highlevel directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Highlevel operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1000+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Highlevel operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Highlevel action and event your agent gets out of the box.

Check Account Funds

Checks if the GoHighLevel account has sufficient funds to cover marketplace charges.

Create Brand Voice

Creates a new brand voice for the specified location in GoHighLevel.

Create Calendars Service Location

Creates a new service location for the calendar services.

Create Email Template Folder

Creates a new email template folder for the specified location.

Create FAQ

Creates a new FAQ inside a knowledge base.

Create Media Folder

Creates a new folder in the media storage for a location.

Create Product

Creates a new product with the specified details in the HighLevel system.

Create Tag

Creates a new tag for the specified location.

Delete Agent

Deletes an agent and all its versions from Agent Studio.

Delete Association

Deletes a user-defined association by its ID.

Delete Business

Deletes a business by its unique identifier.

Delete Service Booking

Deletes a service booking by its ID from the GoHighLevel calendar system.

Delete Conversation AI Agent Action

Permanently deletes an action from a conversation AI agent.

Delete Email Template

Deletes an email template by its ID for a specified location.

Delete Event Notification

Deletes a notification from a calendar by removing the specified notification ID.

Delete Knowledge Base Trained Pages

Deletes trained pages from a knowledge base by their URL identifiers.

Delete Link

Deletes a link by its unique identifier.

Delete Media

Deletes a specific file or folder from the media storage by its unique identifier.

Delete Object Record

Deletes a record by its ID from a specified object schema (business or custom objects).

Delete Product Review

Deletes a product review by its unique identifier.

Delete Relation

Deletes a relation between two objects by its ID.

Delete Store Shipping Zone

Deletes a shipping zone by its unique identifier.

Fetch Email Templates

Fetches email templates for the specified location from the GoHighLevel email builder.

Find Associations

Retrieves all associations for a sub-account / location.

Generate Estimate Number

Generates the next estimate number for the given location.

Get Agent Studio Agents (Deprecated)

Lists all active agents with a published production version for the specified location.

Get All Notes

Retrieves all notes associated with a specific contact.

Get All Tasks

Retrieves all tasks associated with a specific contact.

Get Blogs

Retrieves all blogs for a specific location ID.

Get Brand Boards

Retrieves all brand boards for a specific location.

Get Brand Voice

Retrieves a brand voice by its ID within the specified location.

Get Calendar

Retrieves a single calendar by its unique identifier.

Get Calendars

Retrieves all calendars associated with a GoHighLevel location.

Get Calendar Appointment

Retrieves details for a specific calendar appointment or event by its ID.

Get Event Calendar Schedule

Retrieves the availability schedule for a specific event calendar.

Get Service Bookings

Retrieves service bookings for a location within a given date range, with an optional service location filter.

Get Conversation

Retrieves a specific conversation by its unique identifier.

Get Conversation Messages

Retrieves all messages for a specific conversation in GoHighLevel.

Get Custom Values

Retrieves all custom values associated with a specific location in GoHighLevel.

Get Bulk Action Campaigns

Retrieves all bulk action campaigns for a specific GoHighLevel location.

Get Email Campaigns

Retrieves all email campaigns for a specific GoHighLevel location.

Get Email Templates

Retrieves all email templates for a specific location.

Get Event Notification

Retrieves a single event notification by its unique notification ID.

Get Funnels Page

Retrieves a list of all funnel pages based on the given query parameters.

Get Funnels Page Count

Retrieves the count of funnel pages based on the given query parameters.

Get Invoice Settings

Retrieves invoice settings for a specific location in GoHighLevel.

Get Invoice Schedules

Retrieves a list of invoice schedules for a location or company.

Get Rebilling Config for App

Retrieves rebilling configuration for an app subscription, including subscription and usage plans for the authenticated sub-account.

List Media Files

Fetches a list of files and folders from the media storage for a location.

Get Object Schema

Retrieves the schema definition for an object by its key or ID in GoHighLevel.

Get Object Record By Id

Retrieves a Standard Object (like business) or Custom Object record by its ID.

Get Pipelines

Retrieves all opportunity pipelines associated with a GoHighLevel location.

Get Posts

Retrieves a list of social media posts for a specific location.

List Products

Retrieves a paginated list of products for a specific location.

List Product Prices

Lists all prices associated with a specific product in the HighLevel system.

Get Relations By Record Id

Retrieves all relations for a specific record by its ID.

Get Specific Charge

Retrieves specific wallet charge details by charge ID.

Get Store Settings

Retrieves store settings for a specific location or agency.

Get Timezones

Retrieves all available timezones for a GoHighLevel location.

Get User By Location

Retrieves all users associated with a specific location in GoHighLevel.

List Agent Studio Agents

Lists all active agents for the specified location in Agent Studio.

List Brand Voices

Retrieves all brand voices for a specific location in GoHighLevel.

List Conversation AI Agent Actions

Lists all actions configured for a specific conversation AI agent.

List Funnels Funnel

Retrieves a list of all funnels based on the given query parameters.

List Coupons

Retrieves a list of all coupons available in a GoHighLevel location.

List Proposals Templates

Lists all proposal, estimate, and content library document templates for a location.

Remove Contact From Every Campaign

Removes a contact from all campaigns they are enrolled in.

Search Conversation AI Agents

Searches for AI agents based on various criteria including name, status, and configuration.

Search Conversations

Returns a list of all conversations matching the search criteria along with the sort and filter options selected.

Search Duplicate Contact

Searches for duplicate contacts in a GoHighLevel location.

Search Links

Searches for trigger links within a GoHighLevel location.

Set Default Brand Voice

Sets a brand voice as the default for a location.

Update Association

Updates the labels of an association by its ID.

Update Business

Updates an existing business with the provided information.

Update Calendar

Updates an existing calendar by its unique identifier.

Update Calendar Schedule

Updates an existing calendar's availability schedule.

Update Event Calendar Schedule

Updates the availability schedule for a specific event calendar.

Update Service Booking

Updates an existing service booking in GoHighLevel.

Update Conversation AI Agent

Updates an existing conversation AI agent's configuration in GoHighLevel.

Update Conversation

Updates the conversation details based on the conversation ID.

Update Conversation Message Attachments

Set attachments on an existing conversation message, replacing any existing attachments.

Update Email Template

Updates an existing email template for the specified location.

Update Estimate Template

Updates an existing estimate template by its unique identifier.

Update Estimate Last Visited At

Updates the last visited at timestamp for an estimate.

Update Invoice Schedule

Updates an existing invoice schedule by its unique identifier.

Update Knowledge Base

Updates a knowledge base by its unique identifier.

Bulk Delete Media Files

Bulk soft-deletes or trashes multiple files and folders in a single request.

Bulk Update Media Files

Updates metadata or status of multiple files and folders in bulk.

Update Product Review

Updates the status, reply, and other details of a product review.

Update Tag

Updates an existing tag for the specified location.

Update Task Completed

Updates the completed status of a task associated with a contact.

Update Voice AI Agent

Partially updates an existing voice AI agent's configuration.

Upload File to Custom Fields

Upload files to custom fields.

Upload Media File

Upload a file to the Highlevel Media Library.

FRAMEWORKS

How to build Highlevel MCP Agent with another framework

FAQ

Frequently asked questions

With a standalone Highlevel MCP server, the agents and LLMs can only access a fixed set of Highlevel tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Highlevel and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Highlevel tools.

Yes, absolutely. You can configure which Highlevel scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Highlevel data and credentials are handled as safely as possible.

Start with Highlevel.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Highlevel tool your agent needs.Free to start.

Start building