GoHighLevel

🚨IMPORTANT: FOUNDATIONAL PROJECT NOTICE

⚠️ This is a BASE-LEVEL foundational project designed to connect the GoHighLevel community with AI automation through MCP (Model Context Protocol).

- Foundation Layer: Provides access to ALL sub-account level GoHighLevel API endpoints via MCP
- Community Starter: Built to get the community moving forward together, faster
- Open Architecture: API client and types can be further modularized and segmented as needed
- Educational Resource: Learn how to integrate GoHighLevel with AI systems

- Memory/Recall Systems: If you don't implement proper memory or recall mechanisms, AI may perform unintended actions
- Rate Limiting: Monitor API usage to avoid hitting GoHighLevel rate limits
- Permission Controls: Understand that this provides FULL access to your sub-account APIs
- Data Security: All actions are performed with your API credentials - ensure proper security practices

- Personal/Business Use: Integrate your own GoHighLevel accounts with AI
- Development Base: Build upon this foundation for custom solutions
- Learning & Experimentation: Understand GoHighLevel API patterns
- Community Contribution: Help improve and extend this foundation

- Direct Resale: This is freely available community software
- Production Without Testing: Always test thoroughly in development environments
- Unmonitored AI Usage: Implement proper safeguards and monitoring

📋 Required: Private Integrations API Key

⚠️ This project requires a PRIVATE INTEGRATIONS API key, not a regular API key!

How to get your Private Integrations API Key:

Navigate to Settings→Integrations→Private Integrations

- Name:MCP Server Integration(or your preferred name)
- Webhook URL: Leave blank (not needed)

Select Required Scopesbased on tools you'll use:

- ✅contacts.readonly- View contacts
- ✅contacts.write- Create/update contacts
- ✅conversations.readonly- View conversations
- ✅conversations.write- Send messages
- ✅opportunities.readonly- View opportunities
- ✅opportunities.write- Manage opportunities
- ✅calendars.readonly- View calendars/appointments
- ✅calendars.write- Create/manage appointments
- ✅locations.readonly- View location data
- ✅locations.write- Manage location settings
- ✅workflows.readonly- View workflows
- ✅campaigns.readonly- View campaigns
- ✅blogs.readonly- View blog content
- ✅blogs.write- Create/manage blog posts
- ✅users.readonly- View user information
- ✅custom_objects.readonly- View custom objects
- ✅custom_objects.write- Manage custom objects
- ✅invoices.readonly- View invoices
- ✅invoices.write- Create/manage invoices
- ✅payments.readonly- View payment data
- ✅products.readonly- View products
- ✅products.write- Manage products

Save Integrationand copy the generatedPrivate API Key

Copy your Location IDfrom Settings → Company → Locations

💡 Tip:You can always add more scopes later by editing your Private Integration if you need additional functionality.

This project was a 'time-taker' but I felt it was important. Feel free to donate - everything will go into furthering this Project -> Aiming for Mass Agency "Agent Driven Operations".

🔥 Transform Claude Desktop into a complete GoHighLevel CRM powerhouse with 269+ powerful tools across 19+ categories

This comprehensive MCP (Model Context Protocol) server connects Claude Desktop directly to your GoHighLevel account, providing unprecedented automation capabilities:

- 👥 Complete Contact Management: 31 tools for contacts, tasks, notes, and relationships
- 💬 Advanced Messaging: 20 tools for SMS, email, conversations, and call recordings
- 🏢 Business Operations: Location management, custom objects, workflows, and surveys
- 💰 Sales & Revenue: Opportunities, payments, invoices, estimates, and billing automation
- 📱 Marketing Automation: Social media, email campaigns, blog management, and media library
- 🛒 E-commerce: Store management, products, inventory, shipping, and order fulfillment

- ✅ Free tier with generous limits
- ✅ Automatic HTTPS and global CDN
- ✅ Zero-config deployment
- ✅ Perfect for MCP servers

- ✅ $5 free monthly credit
- ✅ Simple one-click deployment
- ✅ Automatic scaling
- ✅ Great for production workloads

- ✅ Free tier available
- ✅ Auto-deploy from GitHub
- ✅ Built-in SSL

- create_contact,search_contacts,get_contact,update_contact,delete_contact
- add_contact_tags,remove_contact_tags- Organize with tags

- get_contact_tasks,create_contact_task,update_contact_task,delete_contact_task
- get_contact_notes,create_contact_note,update_contact_note,delete_contact_note

- upsert_contact- Smart create/update
- get_duplicate_contact- Duplicate detection
- bulk_update_contact_tags- Mass tag operations
- add_contact_to_workflow,remove_contact_from_workflow- Workflow automation
- add_contact_followers,remove_contact_followers- Team collaboration

💬 Messaging & Conversations (20 Tools)

- send_sms,send_email- Send messages with rich formatting
- search_conversations,get_conversation,create_conversation

- get_message,get_email_message,upload_message_attachments
- update_message_status,cancel_scheduled_message

- get_message_recording,get_message_transcription,download_transcription
- add_inbound_message,add_outbound_call- Manual logging

- live_chat_typing- Real-time typing indicators

- create_blog_post,update_blog_post- Content creation with SEO
- get_blog_posts,get_blog_sites- Content discovery
- get_blog_authors,get_blog_categories- Organization
- check_url_slug- SEO validation

- search_opportunities- Advanced filtering by pipeline, stage, contact
- get_pipelines- Sales pipeline management
- create_opportunity,update_opportunity,delete_opportunity
- update_opportunity_status- Quick win/loss updates
- upsert_opportunity- Smart pipeline management
- add_opportunity_followers,remove_opportunity_followers

🗓️ Calendar & Appointments (14 Tools)

- get_calendar_groups,get_calendars,create_calendar
- update_calendar,delete_calendar

- get_calendar_events,get_free_slots- Availability checking
- create_appointment,get_appointment,update_appointment,delete_appointment

- create_block_slot,update_block_slot- Time blocking

- get_email_campaigns- Campaign management
- create_email_template,get_email_templates- Template system
- update_email_template,delete_email_template

- search_locations,get_location,create_location,update_location,delete_location

- get_location_tags,create_location_tag,update_location_tag,delete_location_tag

- get_location_custom_fields,create_location_custom_field,update_location_custom_field
- get_location_custom_values,create_location_custom_value,update_location_custom_value

- get_location_templates,delete_location_template,get_timezones

- verify_email- Deliverability and risk assessment

- search_social_posts,create_social_post,get_social_post
- update_social_post,delete_social_post,bulk_delete_social_posts

- get_social_accounts,delete_social_account,start_social_oauth

- upload_social_csv,get_csv_upload_status,set_csv_accounts

- get_social_categories,get_social_tags,get_social_tags_by_ids

Platforms:Google Business, Facebook, Instagram, LinkedIn, Twitter, TikTok

- get_media_files- Search and filter media
- upload_media_file- File uploads and hosted URLs
- delete_media_file- Clean up media assets

- get_all_objects,create_object_schema,get_object_schema,update_object_schema

- create_object_record,get_object_record,update_object_record,delete_object_record

- search_object_records- Query custom data

Use Cases:Pet records, support tickets, inventory, custom business data

- ghl_get_all_associations,ghl_create_association,ghl_get_association_by_id
- ghl_update_association,ghl_delete_association
- ghl_create_relation,ghl_get_relations_by_record,ghl_delete_relation
- Advanced relationship mapping between objects

- ghl_get_custom_field_by_id,ghl_create_custom_field,ghl_update_custom_field
- ghl_delete_custom_field,ghl_get_custom_fields_by_object_key
- ghl_create_custom_field_folder,ghl_update_custom_field_folder,ghl_delete_custom_field_folder

- ghl_get_workflows- Automation workflow discovery

- ghl_get_surveys- Survey management
- ghl_get_survey_submissions- Response analysis

- ghl_create_shipping_zone,ghl_list_shipping_zones,ghl_get_shipping_zone
- ghl_update_shipping_zone,ghl_delete_shipping_zone

- ghl_get_available_shipping_rates,ghl_create_shipping_rate,ghl_list_shipping_rates
- ghl_get_shipping_rate,ghl_update_shipping_rate,ghl_delete_shipping_rate

- ghl_create_shipping_carrier,ghl_list_shipping_carriers,ghl_update_shipping_carrier
- ghl_create_store_setting,ghl_get_store_setting

- ghl_create_product,ghl_list_products,ghl_get_product
- ghl_update_product,ghl_delete_product

- ghl_create_price,ghl_list_prices,ghl_list_inventory

- ghl_create_product_collection,ghl_list_product_collections

- create_whitelabel_integration_provider,list_whitelabel_integration_providers

- list_orders,get_order_by_id,create_order_fulfillment,list_order_fulfillments

- list_transactions,get_transaction_by_id

- list_subscriptions,get_subscription_by_id

- list_coupons,create_coupon,update_coupon,delete_coupon,get_coupon

- create_custom_provider_integration,delete_custom_provider_integration
- get_custom_provider_config,create_custom_provider_config

- create_invoice_template,list_invoice_templates,get_invoice_template
- update_invoice_template,delete_invoice_template
- update_invoice_template_late_fees,update_invoice_template_payment_methods

- create_invoice_schedule,list_invoice_schedules,get_invoice_schedule
- update_invoice_schedule,delete_invoice_schedule,schedule_invoice_schedule
- auto_payment_invoice_schedule,cancel_invoice_schedule

- create_invoice,list_invoices,get_invoice,update_invoice
- delete_invoice,void_invoice,send_invoice,record_invoice_payment
- generate_invoice_number,text2pay_invoice

- create_estimate,list_estimates,update_estimate,delete_estimate
- send_estimate,create_invoice_from_estimate,generate_estimate_number

- list_estimate_templates,create_estimate_template,update_estimate_template
- delete_estimate_template,preview_estimate_template

"Search for contacts tagged 'VIP' who haven't been contacted in 30 days, then send them a personalized SMS about our new premium service offering"

"Create an opportunity for contact John Smith for our Premium Package worth $5000, add it to the 'Enterprise Sales' pipeline, and schedule a follow-up appointment for next Tuesday"

"Get all invoices from the last quarter, analyze payment patterns, and create a report of our top-paying customers with their lifetime value"

"List all products with low inventory, create a restock notification campaign, and send it to contacts tagged 'inventory-manager'"

"Create a social media post announcing our Black Friday sale, schedule it for all connected platforms, and track engagement metrics"