@elitedcs/ghl-mcp 3.9.0 → 3.10.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 3.10.0 — Email Templates (gap-closure round 2)
+
+**190 tools across 39 modules. Bundle: 304.6 KB.**
+
+Closes another buyer-visible gap from the v3.8.1 analysis. Email templates power both standalone marketing emails and workflow email actions — agencies have been asking for programmatic management since day one.
+
+### How GHL's API is structured
+GHL calls these "builders" in the public API (the term comes from the drag-and-drop email-builder UI). One template is one builder. Each template has metadata (id, title, type, version, lastUpdated) plus HTML content stored separately in Firebase storage.
+
+### 3 new tools
+- **`list_email_templates`** — paginated list of all email templates in a location
+- **`create_email_template`** — create a template shell. Required: `title`, `type` (one of `html`, `folder`, `import`, `builder`, `blank`, `ai_template`, `vibe-editor`). Response includes the new template `id`.
+- **`update_email_template`** — save HTML content into an existing template. Takes `templateId`, `html`, `editorType` (one of `html`, `builder`), and optional `updatedBy` (defaults to "mcp"). Response includes the Firebase storage preview URL.
+
+### Endpoint discovery transparency
+Probed extensively. **Three endpoints work on the public API:**
+- `GET /emails/builder?locationId=X` — list ✅
+- `POST /emails/builder` with `{locationId, title, type}` — create ✅
+- `POST /emails/builder/data` with `{locationId, templateId, html, editorType, updatedBy}` — save content ✅
+
+**Three operations are NOT on the public API:**
+- `GET /emails/builder/{id}` returns 404 — single-get doesn't exist
+- `PUT /emails/builder/{id}` returns 404 — renaming after create is not exposed
+- `DELETE /emails/builder/{id}` returns 404 — deletion is not exposed (also tried on the internal backend.leadconnectorhq.com host with the same auth — still 404)
+
+These three likely live on GHL's internal API behind Firebase auth. Reaching them would need the same DevTools-capture work that unlocked workflow-builder and funnel-builder. Buyers can delete/rename via the GHL UI for now.
+
+### Round-trip verified against MCP Testing
+- 3/3 new tools registered (190 total)
+- Created template → saved HTML content with merge-field syntax → listed and confirmed the template appeared with the new `templateType: html` flag and a Firebase storage preview URL.
+
+### Tool count impact
+- Total: 187 → 190 (+3)
+- Without Firebase: 157 → 160 (all new tools are public API)
+
+### Field-name quirk worth knowing
+On WRITE, the title field is called `title`. On READ in the list response, it shows up as `name`. The `create_email_template` tool's parameter is `title` (matching write); the list response gives buyers `name` (matching GHL's read shape). Not something Claude needs to worry about — the tools handle the conversion implicitly.
+
+### Files changed
+- `src/tools/emails.ts` — added 3 template tools alongside the existing `get_email_campaigns`
+
 ## 3.9.0 — Products + Trigger Links CRUD (gap-closure round 1)
 
 **187 tools across 39 modules. Bundle: 300.9 KB.**

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 187 tools across 39 modules — manage contacts, conversations, pipelines, calendars, funnels, workflows, invoices, custom objects, webhooks, and more. **Includes full workflow builder, funnel/page editor, form builder, pipeline builder, bulk operations, account export, and workflow cloning** — capabilities no other GHL tool offers.
+**Full GoHighLevel API access for Claude.** 190 tools across 39 modules — manage contacts, conversations, pipelines, calendars, funnels, workflows, invoices, custom objects, webhooks, and more. **Includes full workflow builder, funnel/page editor, form builder, pipeline builder, bulk operations, account export, and workflow cloning** — capabilities no other GHL tool offers.
 
 **Distributed via npm as [`@elitedcs/ghl-mcp`](https://www.npmjs.com/package/@elitedcs/ghl-mcp).** Buyers install with one config block — no git, no Node.js setup, no terminal commands. Updates flow automatically (`npx @latest` re-resolves on every Claude restart).
 
@@ -138,7 +138,7 @@ https://app.gohighlevel.com/v2/location/YOUR_LOCATION_ID/dashboard
 
 ## Enable Workflow Builder (Optional)
 
-The 30 builder + cloner + validator tools (workflow builder, funnel builder, form builder, pipeline builder, workflow cloner, validate_workflow) use GHL'''s internal API and require Firebase credentials. Without them, the other 157 tools work fine — you just won'''t have workflow/funnel/form/pipeline editing.
+The 30 builder + cloner + validator tools (workflow builder, funnel builder, form builder, pipeline builder, workflow cloner, validate_workflow) use GHL'''s internal API and require Firebase credentials. Without them, the other 160 tools work fine — you just won'''t have workflow/funnel/form/pipeline editing.
 
 Grab the three values from your GHL browser session, then re-run `setup_ghl_mcp` with them:
 
@@ -167,9 +167,9 @@ Re-run setup_ghl_mcp with workflow builder:
 
 ---
 
-## Tools (187)
+## Tools (190)
 
-> **v3.9.0 closes the Products + Trigger Links gap.** New: full Products CRUD (`list_products`, `get_product`, `create_product`, `update_product`, `delete_product`, `list_product_prices`) — products underlie invoices, memberships, courses, and e-commerce. New: Trigger Links CRUD (`create_trigger_link`, `update_trigger_link`, `delete_trigger_link`) — agencies use these for trackable links in campaigns. Both use the public GHL API (no Firebase needed).
+> **v3.10.0 adds Email Templates** (`list_email_templates`, `create_email_template`, `update_email_template`) — Claude can now create new HTML email templates and save content into them via the public API. Templates power both standalone marketing emails and workflow email actions. Delete + rename remain UI-only (no public-API endpoint exists).
 
 ### CRM & Contacts (15 tools)
 

package/dist/index.js

@@ -31,8 +31,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.9.0",
-      description: "GoHighLevel MCP Server for Claude. 187 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+      version: "3.10.0",
+      description: "GoHighLevel MCP Server for Claude. 190 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"
@@ -3577,11 +3577,13 @@ function registerBlogTools(server2, client) {
 
 // src/tools/emails.ts
 var import_zod24 = require("zod");
+var TEMPLATE_TYPES = ["html", "folder", "import", "builder", "blank", "ai_template", "vibe-editor"];
+var EDITOR_TYPES = ["html", "builder"];
 function registerEmailTools(server2, client) {
   safeTool(
     server2,
     "get_email_campaigns",
-    "List email campaigns for a location",
+    "List email campaigns for a location.",
     {
       locationId: import_zod24.z.string().optional().describe("GHL Location ID (optional if GHL_LOCATION_ID is set)")
     },
@@ -3592,6 +3594,60 @@ function registerEmailTools(server2, client) {
       });
     }
   );
+  safeTool(
+    server2,
+    "list_email_templates",
+    "List email templates ('builders') in a location. Templates power both standalone marketing emails and email actions inside workflows. Returns each template's id, name (display title), type, version, last-updated timestamp, and Firebase storage preview URL.",
+    {
+      locationId: import_zod24.z.string().optional().describe("GHL Location ID (optional if GHL_LOCATION_ID is set).")
+    },
+    async ({ locationId: locationId2 }) => {
+      const resolvedLocationId = client.resolveLocationId(locationId2);
+      return client.get("/emails/builder", {
+        params: { locationId: resolvedLocationId }
+      });
+    }
+  );
+  safeTool(
+    server2,
+    "create_email_template",
+    "Create a new email template (a 'builder' in GHL's API). Creates the metadata shell; use update_email_template to save HTML content into it. After creation, the response includes the template `id` which you'll use with update_email_template + when referencing the template from workflow email actions.",
+    {
+      title: import_zod24.z.string().describe("Display name for the template (e.g., 'May Newsletter \u2014 V2'). Shown in the GHL UI. Note: GHL stores this as `name` on read but expects `title` on write."),
+      type: import_zod24.z.enum(TEMPLATE_TYPES).describe("Template kind. 'blank' = empty starting point. 'html' = raw HTML import. 'builder' = drag-and-drop builder. 'import' = imported from an external source. 'ai_template' / 'vibe-editor' = AI-generated. 'folder' = organizational folder (no content)."),
+      locationId: import_zod24.z.string().optional().describe("Location ID. Falls back to GHL_LOCATION_ID env var.")
+    },
+    async ({ title, type, locationId: locationId2 }) => {
+      const resolvedLocationId = client.resolveLocationId(locationId2);
+      return client.post("/emails/builder", {
+        body: { locationId: resolvedLocationId, title, type }
+      });
+    }
+  );
+  safeTool(
+    server2,
+    "update_email_template",
+    "Save HTML content into an existing email template. Use this to update the body of a template after `create_email_template`. The `updatedBy` field is required by GHL; defaults to 'mcp' if not provided. Note: this updates CONTENT only. Renaming the title or deleting the template is not yet possible through the public API \u2014 do those in the GHL UI for now.",
+    {
+      templateId: import_zod24.z.string().describe("The template ID to update (from create_email_template or list_email_templates)."),
+      html: import_zod24.z.string().describe("The full HTML body of the email. Can include merge fields like {{contact.first_name}}."),
+      editorType: import_zod24.z.enum(EDITOR_TYPES).describe("Which editor produced this content. 'html' for raw HTML; 'builder' if you're saving a drag-and-drop builder export. After this save, the template will be flagged as the chosen editorType in lists."),
+      updatedBy: import_zod24.z.string().optional().describe("Identifier of who's making the change (a user ID or label). Defaults to 'mcp' if omitted. Shown in the GHL audit log for this template."),
+      locationId: import_zod24.z.string().optional().describe("Location ID. Falls back to GHL_LOCATION_ID env var.")
+    },
+    async ({ templateId, html, editorType, updatedBy, locationId: locationId2 }) => {
+      const resolvedLocationId = client.resolveLocationId(locationId2);
+      return client.post("/emails/builder/data", {
+        body: {
+          locationId: resolvedLocationId,
+          templateId,
+          html,
+          editorType,
+          updatedBy: updatedBy ?? "mcp"
+        }
+      });
+    }
+  );
 }
 
 // src/tools/trigger-links.ts
@@ -6965,7 +7021,7 @@ async function validateFirebase(firebaseKey, refreshToken) {
 function registerSetupTool(server2) {
   server2.tool(
     "setup_ghl_mcp",
-    "First-run setup for GHL Command MCP. Validates your license and GHL credentials, then writes them to a per-user credentials file. Restart Claude after this completes to load all 187 tools (157 if you skip the optional Firebase fields; add Firebase later with enable_workflow_builder).",
+    "First-run setup for GHL Command MCP. Validates your license and GHL credentials, then writes them to a per-user credentials file. Restart Claude after this completes to load all 190 tools (160 if you skip the optional Firebase fields; add Firebase later with enable_workflow_builder).",
     {
       email: import_zod43.z.string().email().describe("Email used at purchase."),
       license_key: import_zod43.z.string().min(20).describe("License key from your purchase email."),
@@ -7020,7 +7076,7 @@ Note: Firebase credentials rejected (${fb.error}). Saved without Workflow Builde
         ghl_firebase_api_key: workflowBuilderEnabled ? args.ghl_firebase_api_key?.trim() : void 0,
         ghl_firebase_refresh_token: workflowBuilderEnabled ? args.ghl_firebase_refresh_token?.trim() : void 0
       });
-      const toolCount = workflowBuilderEnabled ? "187" : "157";
+      const toolCount = workflowBuilderEnabled ? "190" : "160";
       const wfLine = workflowBuilderEnabled ? "Workflow Builder: enabled." : "Workflow Builder: not configured (optional).";
       const wfTip = workflowBuilderEnabled ? "" : "\nTo enable Workflow Builder later (8 extra tools): run enable_workflow_builder with your three Firebase values. No need to re-enter license/API key/location ID.";
       return {
@@ -7048,7 +7104,7 @@ Note: Firebase credentials rejected (${fb.error}). Saved without Workflow Builde
 function registerEnableWorkflowBuilderTool(server2) {
   server2.tool(
     "enable_workflow_builder",
-    "Add Firebase credentials to an existing GHL Command install to unlock 30 additional tools across 6 modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder (10 tools), form builder (5 tools), pipeline builder (5 tools), and workflow cloning. Requires you've already run setup_ghl_mcp. Capture the three Firebase values from your GHL browser session \u2014 see elitedcs.com/ghl-mcp-firebase for step-by-step DevTools instructions. Tool count goes from 157 to 187 after the next Claude restart.",
+    "Add Firebase credentials to an existing GHL Command install to unlock 30 additional tools across 6 modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder (10 tools), form builder (5 tools), pipeline builder (5 tools), and workflow cloning. Requires you've already run setup_ghl_mcp. Capture the three Firebase values from your GHL browser session \u2014 see elitedcs.com/ghl-mcp-firebase for step-by-step DevTools instructions. Tool count goes from 160 to 190 after the next Claude restart.",
     {
       ghl_user_id: import_zod43.z.string().min(10).describe("Firebase User ID (uid). DevTools \u2192 Application \u2192 IndexedDB \u2192 firebaseLocalStorageDb \u2192 firebaseLocalStorage \u2192 the value.uid field of the firebase:authUser row."),
       ghl_firebase_api_key: import_zod43.z.string().min(10).describe("Firebase API Key starting with 'AIza'. The string between 'firebase:authUser:' and ':[DEFAULT]' in the row's Key column."),
@@ -7095,7 +7151,7 @@ DevTools steps: https://elitedcs.com/ghl-mcp-firebase`
             "",
             "Firebase credentials verified and saved.",
             "",
-            "**Restart Claude (quit fully and reopen) to load the workflow builder + funnel builder + pipeline builder + form builder + workflow cloner tools (187 total).**",
+            "**Restart Claude (quit fully and reopen) to load the workflow builder + funnel builder + pipeline builder + form builder + workflow cloner tools (190 total).**",
             "",
             'After restart, try: "List my workflows in full detail" or "Validate workflow <id>".',
             "",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.9.0",
-  "description": "GoHighLevel MCP Server for Claude. 187 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+  "version": "3.10.0",
+  "description": "GoHighLevel MCP Server for Claude. 190 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
   "main": "dist/index.js",
   "bin": {
     "ghl-mcp": "dist/index.js"