GoHighLevel

Instead of trying to tackle this ---- use our hosted version --- GHL Agent Framework, One Click to Sign in!

https://www.strategixagents.com/

🚀 GoHighLevel MCP Server

🚨 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).

🎯 What This Project Is:

• 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

⚠️ Critical AI Safety Considerations:

• 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

🎯 Intended Use:

• 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

🚫 NOT Intended For:

• 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

---

🔑 CRITICAL: GoHighLevel API Setup

📋 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:

1. Login to your GoHighLevel account

2. Navigate to Settings → Integrations → Private Integrations

3. Create New Private Integration:

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

4. Select Required Scopes based 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

5. Save Integration and copy the generated Private API Key

6. Copy your Location ID from 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

🎯 What This Does

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

⚡ Quick Deploy Options

🟢 Vercel (Recommended)

Why Vercel:

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

🚂 Railway

Why Railway:

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

🎨 Render

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

🌟 Complete Tool Catalog (269 Tools)

🎯 Contact Management (31 Tools)

Core Operations:

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

Task & Note Management:

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

Advanced Features:

• 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)

Direct Communication:

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

Message Management:

• get_message, get_email_message, upload_message_attachments
• update_message_status, cancel_scheduled_message

Call Features:

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

Live Chat:

• live_chat_typing - Real-time typing indicators

📝 Blog Management (7 Tools)

• 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

💰 Opportunity Management (10 Tools)

• 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)

Calendar Management:

• get_calendar_groups, get_calendars, create_calendar
• update_calendar, delete_calendar

Appointment Booking:

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

Schedule Control:

• create_block_slot, update_block_slot - Time blocking

📧 Email Marketing (5 Tools)

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

🏢 Location Management (24 Tools)

Sub-Account Management:

• search_locations, get_location, create_location, update_location, delete_location

Tag System:

• get_location_tags, create_location_tag, update_location_tag, delete_location_tag

Custom Fields & Values:

• get_location_custom_fields, create_location_custom_field, update_location_custom_field
• get_location_custom_values, create_location_custom_value, update_location_custom_value

Templates & Settings:

• get_location_templates, delete_location_template, get_timezones

✅ Email Verification (1 Tool)

• verify_email - Deliverability and risk assessment

📱 Social Media Management (17 Tools)

Post Management:

• search_social_posts, create_social_post, get_social_post
• update_social_post, delete_social_post, bulk_delete_social_posts

Account Integration:

• get_social_accounts, delete_social_account, start_social_oauth

Bulk Operations:

• upload_social_csv, get_csv_upload_status, set_csv_accounts

Organization:

• get_social_categories, get_social_tags, get_social_tags_by_ids

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

📁 Media Library (3 Tools)

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

---

README truncated. View full README on GitHub.