Provides access to GHL CRM operations and sales pipeline tools.

Install

mkdir -p .claude/skills/ghl && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/17552" && unzip -o skill.zip -d .claude/skills/ghl && rm skill.zip

Installs to .claude/skills/ghl

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

How to use GoHighLevel (GHL) CRM for contacts, opportunities, pipelines, funnels, voice AI, tasks, and social media management
126 charsno explicit “when” trigger
Intermediate

Key capabilities

  • List and search contacts in GHL
  • Manage sales pipelines and opportunities
  • Create and manage notes, tasks, and tags for contacts
  • List and get funnel details and stats
  • Manage social media posts and workflows

How it works

It provides programmatic access to GoHighLevel CRM functionalities through a set of defined skills, allowing for management of contacts, opportunities, pipelines, funnels, and other CRM-related tasks.

Inputs & outputs

You give it
A request to interact with GoHighLevel CRM data or functionality
You get back
CRM data (e.g., contact lists, opportunity details) or actions performed within GHL (e.g., contact creation, task assignment)

When to use ghl

  • Listing sales opportunities
  • Updating contact information
  • Moving leads through a pipeline

About this skill

GoHighLevel (GHL) CRM — Reference Skill

Authentication

  • API Key via GHL_API_KEY env var
  • Location ID via GHL_LOCATION_ID env var
  • Connector: tesseract_operator/connectors/ghl.py
  • Skills: tesseract_operator/skills/ghl_skills.py, ghl_outreach_skills.py

Available Skills (37 total)

Contacts

SkillRiskMCPDescription
ghl.contacts.listLOWList/search contacts
ghl.contacts.getLOWGet single contact
ghl.contacts.createMEDIUMCreate contact
ghl.contacts.updateMEDIUMUpdate contact fields
ghl.contacts.deleteHIGHDelete a contact — requires approval
ghl.contacts.searchLOWSearch by name/email/phone
ghl.journey.mapLOWUser journey assembled from GHL data
ghl.journey.attributionsLOWUTM/source attribution for a contact

Pipeline & Opportunities

SkillRiskMCPDescription
ghl.pipelines.listLOWList pipelines
ghl.pipeline.stagesLOWList sales pipeline stages
ghl.pipeline.move_stageMEDIUMMove opportunity to a named stage
ghl.pipeline.draft_outreachLOWDraft personalized outreach emails
ghl.opportunities.listLOWList opportunities
ghl.opportunities.getLOWGet single opportunity
ghl.opportunities.createMEDIUMCreate opportunity
ghl.opportunities.updateMEDIUMUpdate opportunity
ghl.opportunities.deleteHIGHDelete opportunity — requires approval

Notes, Tasks, Tags

SkillRiskMCPDescription
ghl.notes.listLOWList contact notes
ghl.notes.createMEDIUMCreate contact note
ghl.tasks.listLOWList contact tasks
ghl.tasks.createMEDIUMCreate contact task
ghl.tags.listLOWList all tags
ghl.tags.addMEDIUMAdd tags to contact
ghl.tags.removeMEDIUMRemove tags from contact
ghl.custom_fields.listLOWList custom fields

Funnels

SkillRiskMCPDescription
ghl.funnels.listLOWList all funnels
ghl.funnels.getLOWGet single funnel
ghl.funnels.pagesLOWList funnel pages
ghl.funnels.statsLOWGet funnel stats
ghl.funnels.optinsLOWCount opt-ins by source
ghl.funnel_notes.listLOWList funnel notes
ghl.funnel_notes.getLOWGet single funnel note
ghl.funnel_notes.createMEDIUMCreate funnel note
ghl.funnel_notes.updateMEDIUMUpdate funnel note
ghl.funnel_notes.deleteHIGHDelete funnel note — requires approval

Voice, Social, Workflows, Users

SkillRiskMCPDescription
ghl.voice.listLOWList voice agent calls
ghl.voice.transcriptLOWGet call transcript
ghl.voice.triggerHIGHTrigger outbound call — requires approval
ghl.social.accountsLOWList connected social accounts
ghl.social.postMEDIUMSchedule social media post
ghl.workflow.add_contactMEDIUMAdd contact to automation workflow
ghl.users.listLOWList GHL users

Pipeline Stages (auto-populated)

Configured in .env as GHL_SALES_STAGE_* variables. Use ghl.pipeline.stages to list.

CRM Alignment (Big Cleanup)

SkillRiskMCPDescription
ghl.crm.alignHIGHFull pipeline cleanup: dedup + crossval + fix stages + fix notes

Script: scripts/ghl_crm_align.py Workflow: .agent/workflows/crm-align.md

Run when user says: "align CRM", "clean up pipeline", "fix GHL", "remove duplicates", "CRM alignment", "pipeline cleanup", or "fix stages/notes".

# Dry run (report only)
python scripts/ghl_crm_align.py

# Apply all fixes
python scripts/ghl_crm_align.py --fix

# Fast dedup only
python scripts/ghl_crm_align.py --fix --skip-crossval

# Export report
python scripts/ghl_crm_align.py --csv reports/crm_align.csv

Phases: SNAPSHOT → DEDUP → CROSSVAL → NOTES → STAGE-FIX → REPORT Zero LLM tokens — fully deterministic rule-based classification.

Cross-Validation & Diagnostics

SkillRiskMCPDescription
ghl.pipeline.crossvalLOWCross-validate pipeline against Gmail/Calendar/Fireflies/Instantly
ghl.pipeline.deduplicateHIGHRemove duplicate opportunities (keeping most advanced stage)

Known Gotchas

  1. Location-scoped API — all requests are scoped to GHL_LOCATION_ID
  2. Rate limit: ~100 req/min. Add time.sleep(0.3) between batches
  3. Contact search is partial-match — use ghl.contacts.search for fuzzy
  4. Pipeline stage IDs are UUIDs stored in .env — use ghl.pipeline.move_stage with stage NAME not ID

When not to use it

  • When deleting contacts or opportunities without approval
  • When triggering outbound calls without approval
  • When performing full pipeline cleanup without explicit user invocation

Prerequisites

GHL_API_KEY env varGHL_LOCATION_ID env var

Limitations

  • Requires `GHL_API_KEY` and `GHL_LOCATION_ID` environment variables
  • Certain high-risk operations require explicit approval

How it compares

This skill offers a structured, programmatic interface to GoHighLevel CRM, enabling automated and precise interactions with CRM data and processes, unlike manual CRM usage.

Compared to similar skills

ghl side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
ghl (this skill)01moReviewIntermediate
zendesk153moReviewIntermediate
zapier-workflows118moReviewBeginner
controlling-spotify73moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

Search skills

Search the agent skills registry