HighLevel MCP. Manage contacts, deals, and appointments via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
HighLevel MCP Server. Manage your entire sales lifecycle—contacts, opportunities, and appointments—directly from your AI client. You can search leads, check calendar availability, book meetings, and track follow-up tasks without leaving your chat window.
It connects to your HighLevel account API v2, giving your agent full visibility into your CRM.
What your AI agents can do
Create appointment
Books a new meeting time on a calendar.
Create contact
Adds a new contact or lead to HighLevel using required details like first name or email.
Create contact task
Assigns a specific follow-up task to an existing contact.
Find specific leads using search_contacts or pull a full record history for any contact with get_contact_details.
List your sales pipelines and search for specific opportunities to track deal value and status using list_pipelines and search_opportunities.
Determine available time slots across multiple calendars with get_calendar_free_slots and book new meetings instantly using create_appointment.
Assign new tasks to contacts using create_contact_task and review all assigned follow-ups with list_contact_tasks.
Create new contact entries (create_contact) or set up an appointment (create_appointment) using structured data inputs.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
HighLevel MCP Server: 11 Tools for CRM Operations
Manage contacts, schedule appointments, and run reports on deals by calling these 11 specific tools through your AI agent.
019d75b1create appointment
Books a new meeting time on a calendar.
019d75b1create contact
Adds a new contact or lead to HighLevel using required details like first name or email.
019d75b1create contact task
Assigns a specific follow-up task to an existing contact.
019d75b1get calendar free slots
Checks which times are open on a specified calendar.
019d75b1get contact details
Retrieves all detailed information for a specific contact ID.
019d75b1list calendars
Lists all calendars available within your account location.
019d75b1list contact tasks
Shows every task currently assigned to a specific contact.
019d75b1list location tags
Lists all custom location tags you use to categorize your data.
019d75b1list pipelines
Lists all sales pipelines available for your location.
019d75b1search contacts
Searches for contacts across your account using specific search criteria.
019d75b1search opportunities
Finds specific deals and opportunities within a given sales pipeline.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with HighLevel, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You wanna manage your entire sales life cycle—contacts, deals, and meetings—right from your AI client. This server connects to your HighLevel account API v2, so your agent gets full visibility into your CRM.
Search and View Contacts
Use search_contacts to find specific leads across your account when you're working. You can also grab a full record history for any contact with get_contact_details.
Manage Sales Deals
See all your sales pipelines with list_pipelines. You can then find specific deals and opportunities to track deal value and status using search_opportunities.
Schedule and Check Calendars
Check which times are open across multiple calendars using get_calendar_free_slots, and you can book a new meeting instantly by running create_appointment. You'll also see every calendar available in your account location by running list_calendars.
Automate Follow-Ups
Assign a new follow-up task to a contact using create_contact_task. You can also review all tasks currently assigned to a contact by running list_contact_tasks.
Build New Records
Create a new contact entry using create_contact with required details like a first name or email. You can set up an appointment using create_appointment with structured data inputs.
Data Organization
List all custom location tags you use to categorize your data with list_location_tags.
How HighLevel MCP Works
- 1 First, you subscribe to the server and provide your HighLevel API v2 Access Token.
- 2 Your AI client uses the MCP standard to call a specific tool (e.g.,
search_contacts) with parameters. - 3 The server executes the tool against your HighLevel account and returns the structured data to your AI client.
The bottom line is: you tell your agent what you need, and it runs the necessary CRM actions without you opening a web browser.
Who Is HighLevel MCP For?
The Sales Representative who hates logging follow-ups in a separate tool. The Marketing Operations Lead who needs to pull lead details for multiple clients instantly. The Agency Owner who spends too much time switching between the CRM dashboard and the calendar.
Uses the agent to log follow-up tasks via create_contact_task or to book a meeting using create_appointment immediately after a call.
Runs search_contacts to validate lead data, ensuring the contact record is complete before running a campaign.
Quickly checks the status of all deals using search_opportunities across different client pipelines.
What Changes When You Connect
- See a contact's full history instantly. Instead of navigating to the contact tab, use
get_contact_detailsto pull up all information, including activity and notes, in one go. - Schedule meetings without leaving your AI client. You check availability using
get_calendar_free_slotsand book the appointment withcreate_appointment—all in the chat. - Track follow-up tasks automatically. After a call, tell your agent to
create_contact_taskfor the next step. This logs the task right to the contact record. - Keep sales organized. Use
list_pipelinesandsearch_opportunitiesto get a total view of potential revenue without clicking through multiple dashboards. - Handle lead entry on the fly. If you grab a lead name and email, the agent can use
create_contactto log them immediately, ensuring no data is lost. - Categorize data efficiently. Run
list_location_tagsto see what custom tags exist, then use the agent to apply them to contacts for better filtering.
Real-World Use Cases
Need to know a lead's full background.
A rep gets a name from a networking event. Instead of searching the dashboard manually, they prompt: 'Search for John Doe and show his pending tasks.' The agent runs search_contacts and list_contact_tasks, giving the rep a full context summary immediately.
Client needs a meeting booked, but the calendar is complex.
The rep asks the agent to find availability. The agent calls list_calendars first, then runs get_calendar_free_slots for the correct calendar. Finally, it uses create_appointment to book it, all while the rep writes a follow-up email.
A deal is stalling, and tasks need to be logged.
The sales manager notices a deal is stuck. They ask the agent to list opportunities in the 'Product Sales' pipeline. Once the deal is identified, they tell the agent to create_contact_task to assign a follow-up call to the contact.
Onboarding new client data quickly.
The ops team gets a bulk list of leads. Instead of manually entering them, they prompt the agent to search_contacts for existing records and then use create_contact for the new ones, ensuring all leads are logged and tagged.
The Tradeoffs
Manual Data Gathering
The user manually switches between the contact dashboard, the calendar view, and the sales pipeline tab to gather information for a client call.
→
Use the agent to pull everything at once. Prompt the agent to 'Get contact details for [Name] and show pending tasks.' This uses get_contact_details and list_contact_tasks in sequence.
Forgetting to log tasks
The rep successfully calls a prospect, but forgets to manually create a follow-up task in the CRM after hanging up.
→
Immediately use the agent to create_contact_task. Just tell it: 'Create a task for [Name] to follow up on the quote by Friday.' It handles the API call.
Guessing the correct calendar ID
The user tries to manually find free slots but doesn't know which calendar ID to use, wasting time and getting an error message.
→
First, prompt the agent to list_calendars to see all available IDs. Then, ask it to get_calendar_free_slots using the correct ID. This prevents errors.
When It Fits, When It Doesn't
Use this if you need to manage the entire contact lifecycle—from initial lead search to logged appointment and task assignment. It's built for people who need a real-time, conversational view of their CRM data. Don't use it if your only goal is to run a single, isolated report (like exporting a CSV of all contacts). For that, a dedicated reporting tool works better. This server is designed to act on the data, not just read it. If your workflow involves checking who is available, logging a task, or finding a deal, this is the right tool.
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 11 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Jumping between tabs to see a client's history shouldn't take 10 clicks.
Today, if you need to see a client's history, you start at the main dashboard. You click the contact name, then you navigate to the 'Tasks' tab. If you need to know their sales status, you have to click out to the 'Opportunities' tab. Then you check the calendar for available time, which requires a whole other section of the UI. It's a mess of tabs and clicks.
With the HighLevel MCP Server, you just talk to your agent. You tell it, 'Show me John Doe's full file.' The agent runs multiple tools—like `get_contact_details` and `list_contact_tasks`—and gives you the combined summary right in the chat. You get the whole picture, instantly.
HighLevel MCP Server: Automate your CRM tasks from chat.
The biggest time-saver is booking meetings. You don't have to copy-paste a date range and figure out which calendar is available. The agent runs `list_calendars` to check which calendars exist, then `get_calendar_free_slots` to find open time. Then, it calls `create_appointment` to book it.
It's not just viewing data anymore. You're executing actions. You're logging tasks, creating contacts, and booking meetings—all without touching the HighLevel dashboard. It works.
Common Questions About HighLevel MCP
How do I use the `search_contacts` tool with HighLevel MCP Server? +
You provide the search criteria (like a name or email) to your agent. The agent then runs the search_contacts tool using the criteria you gave it.
Can I use `create_contact` to add leads to HighLevel? +
Yes. You instruct your agent to create the contact, providing the necessary details (like first name and email) in the prompt.
What is the difference between `get_contact_details` and `search_contacts`? +
search_contacts finds a list of contacts matching criteria. get_contact_details takes a specific contact ID and pulls the complete, deep profile for that single person.
Does the HighLevel MCP Server handle opportunity tracking? +
Yes. You use list_pipelines to see all available sales pipelines, and then search_opportunities to pull specific deals within them.
What if I need to book a meeting on a different calendar? +
First, run list_calendars to get all IDs. Then, use get_calendar_free_slots specifying the correct calendar ID before calling create_appointment.
How do I use the `create_contact_task` tool to follow up with a lead? +
You pass the contact ID and the task description. This tool assigns a follow-up task directly to the contact record in HighLevel. It's perfect for automating follow-up reminders, so your team never misses a step.
Can I list all sales pipelines using the `list_pipelines` tool? +
Yes, this tool retrieves all sales pipelines available for the account. You can then use the resulting pipeline IDs to search for opportunities, giving you a full overview of your deal flow.
What is the purpose of the `list_location_tags` tool? +
This tool shows all custom tags set up for a location. You use the returned tags to filter and categorize contacts or opportunities, ensuring your data is always organized by specific criteria.
How do I find my HighLevel API v2 Access Token? +
You can obtain an API v2 Access Token by creating an application in the HighLevel Developer Portal (marketplace.gohighlevel.com) and performing the OAuth 2.0 handshake. Ensure you grant the necessary scopes for contacts and opportunities.
Can I check calendar availability in real-time? +
Yes! Use the get_calendar_free_slots tool by providing the calendar ID and a date range. The agent will return all available appointment slots for that period.
Does the integration support creating new opportunities? +
Yes, you can use the create_opportunity tool. You must provide a JSON string containing the pipeline ID, stage ID, and contact details to add a new deal to your sales funnel.
Is the integration secure for CRM data? +
Absolutely. The integration uses official HighLevel API v2 OAuth 2.0 Bearer tokens over HTTPS. Your credentials and customer data are encrypted and stored securely within the Vinkius Cloud infrastructure.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Clearscope
Optimize content via Clearscope — create SEO reports, grade drafts using NLP, perform keyword research, and audit SERP competitors directly from any AI agent.
Criteo Retail Media API
Equip your AI agent to manage Criteo retail campaigns, line items, and product data directly via the Criteo API.
Snapchat Conversions
Send conversion events to Snapchat Ads via the Conversions API with AI agents.
You might also like
ESA Near Earth Objects
Track near-Earth asteroids and comets, access orbital data, and monitor potential impact risks from the European Space Agency.
Missive
Collaborative email and shared inbox for teams.
Anthropic
Interact with Claude models via the Anthropic Messages API — send prompts, manage batches, and monitor rate limits directly.