@elitedcs/ghl-mcp 3.14.0 → 3.15.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 3.15.0 — Email-template delete, rename, archive (Firebase-gated)
+
+**206 tools across 43 modules (+3). Manage email templates without leaving Claude.**
+
+Until now you could create and update email templates through the public API, but deleting or renaming one meant clicking through the GHL UI — the public bearer API 404s on both. Those mutations live on the internal API behind Firebase auth. Confirmed working 2026-05-24 against the MCP Testing sandbox and verified end-to-end (create → rename → archive → unarchive → delete, round-trip clean).
+
+### New tools (3, all require Firebase configured)
+
+- **`delete_email_template`** — hard delete a template by id. Irreversible. Breaks any workflow email action or draft campaign that references it.
+- **`rename_email_template`** — change a template's display title only; HTML content and sender settings untouched.
+- **`archive_email_template`** — archive (`archived: true`) or restore (`archived: false`) a template. Removes it from the active list without deleting it — the reversible alternative to delete.
+
+All three hit `backend.leadconnectorhq.com/emails/builder` with the workflow-builder Firebase token (the GHL UI persists via Firestore, but the REST routes exist server-side). Registered by `registerEmailBuilderInternalTools` in the internal-API block. `update_email_template`'s description now points at `rename_email_template` / `delete_email_template` instead of telling you to use the UI.
+
 ## 3.14.0 — Multi-tenant Firebase: run the workflow builder in clients' accounts
 
 **203 tools across 43 modules (+2). The workflow builder is no longer single-company.**

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 203 tools across 43 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. **Multi-tenant:** one install can run the workflow builder across multiple clients' GHL accounts.
+**Full GoHighLevel API access for Claude.** 206 tools across 43 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. **Multi-tenant:** one install can run the workflow builder across multiple clients' GHL accounts.
 
 **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).
 

package/dist/index.js

@@ -31,8 +31,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.14.0",
-      description: "GoHighLevel MCP Server for Claude. 203 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
+      version: "3.15.0",
+      description: "GoHighLevel MCP Server for Claude. 206 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"
@@ -3860,6 +3860,7 @@ function registerBlogTools(server2, client) {
 
 // src/tools/emails.ts
 var import_zod25 = require("zod");
+var EMAIL_BUILDER_BASE = "https://backend.leadconnectorhq.com/emails/builder";
 var TEMPLATE_TYPES = ["html", "folder", "import", "builder", "blank", "ai_template", "vibe-editor"];
 var EDITOR_TYPES = ["html", "builder"];
 function registerEmailTools(server2, client) {
@@ -3930,7 +3931,7 @@ function registerEmailTools(server2, client) {
   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.",
+    "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. To rename a template use `rename_email_template`; to delete it use `delete_email_template` (both Firebase-gated).",
     {
       templateId: import_zod25.z.string().describe("The template ID to update (from create_email_template or list_email_templates)."),
       html: import_zod25.z.string().describe("The full HTML body of the email. Can include merge fields like {{contact.first_name}}."),
@@ -3952,6 +3953,78 @@ function registerEmailTools(server2, client) {
     }
   );
 }
+function registerEmailBuilderInternalTools(server2, builderClient) {
+  const client = builderClient;
+  if (!client) return;
+  async function builderRequest(method, path6, body) {
+    const headers = await client.buildHeaders();
+    const response = await fetch(`${EMAIL_BUILDER_BASE}${path6}`, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const text2 = await response.text();
+      throw new Error(`Email Builder API Error ${response.status}: ${method} /emails/builder${path6}
+${text2}`);
+    }
+    const text = await response.text();
+    return text ? JSON.parse(text) : { ok: true };
+  }
+  server2.tool(
+    "delete_email_template",
+    "Permanently delete an email template ('builder') by id. This is a HARD delete \u2014 the template is removed, not archived (use archive_email_template if you want a reversible remove). Requires Firebase auth; the public bearer API can't do this. Get the templateId from list_email_templates. WARNING: irreversible. If the template is referenced by a workflow email action or a draft campaign, deleting it will break that reference.",
+    {
+      templateId: import_zod25.z.string().describe("The template id to delete (from list_email_templates, the `id` field)."),
+      locationId: import_zod25.z.string().optional().describe("Location ID. Falls back to the active builder client's location.")
+    },
+    async ({ templateId, locationId: locationId2 }) => {
+      try {
+        const loc = locationId2 ?? client.locationId;
+        const result = await builderRequest("DELETE", `/data/${templateId}?locationId=${loc}`);
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+  server2.tool(
+    "rename_email_template",
+    "Rename an existing email template ('builder'). Updates the display title only; the HTML content and sender settings are left untouched. Requires Firebase auth; the public bearer API can't do this. Get the templateId from list_email_templates.",
+    {
+      templateId: import_zod25.z.string().describe("The template id to rename (from list_email_templates, the `id` field)."),
+      name: import_zod25.z.string().describe("The new display name for the template (e.g., 'May Newsletter \u2014 Final')."),
+      locationId: import_zod25.z.string().optional().describe("Location ID. Falls back to the active builder client's location.")
+    },
+    async ({ templateId, name, locationId: locationId2 }) => {
+      try {
+        const loc = locationId2 ?? client.locationId;
+        const result = await builderRequest("PATCH", `/${templateId}`, { locationId: loc, name });
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+  server2.tool(
+    "archive_email_template",
+    "Archive (or unarchive) an email template ('builder'). Archiving removes it from the active templates list without deleting it \u2014 a reversible alternative to delete_email_template. Requires Firebase auth. Get the templateId from list_email_templates.",
+    {
+      templateId: import_zod25.z.string().describe("The template id to archive/unarchive (from list_email_templates, the `id` field)."),
+      archived: import_zod25.z.boolean().optional().describe("true to archive (default), false to restore from archive."),
+      locationId: import_zod25.z.string().optional().describe("Location ID. Falls back to the active builder client's location.")
+    },
+    async ({ templateId, archived, locationId: locationId2 }) => {
+      try {
+        const loc = locationId2 ?? client.locationId;
+        const result = await builderRequest("PATCH", `/${templateId}`, { locationId: loc, archived: archived ?? true });
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+}
 
 // src/tools/trigger-links.ts
 var import_zod26 = require("zod");
@@ -5658,7 +5731,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 203 tools (163 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 206 tools (163 if you skip the optional Firebase fields; add Firebase later with enable_workflow_builder).",
     {
       email: import_zod37.z.string().email().describe("Email used at purchase."),
       license_key: import_zod37.z.string().min(20).describe("License key from your purchase email."),
@@ -5713,7 +5786,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 ? "203" : "163";
+      const toolCount = workflowBuilderEnabled ? "206" : "163";
       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 {
@@ -7863,6 +7936,7 @@ function registerAllTools(server2, client, registry2, mcpVersion) {
   registerSmartListTools(server2, builderClient);
   registerReputationTools(server2, builderClient);
   registerEmailCampaignTools(server2, builderClient);
+  registerEmailBuilderInternalTools(server2, builderClient);
   registerMembershipTools(server2, builderClient);
   registerValidatorTools(server2, client, builderClient);
   registerDiagnosticTools(server2, mcpVersion ?? "unknown", client, builderClient, registry2 ?? null);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.14.0",
-  "description": "GoHighLevel MCP Server for Claude. 203 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
+  "version": "3.15.0",
+  "description": "GoHighLevel MCP Server for Claude. 206 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
   "main": "dist/index.js",
   "bin": {
     "ghl-mcp": "dist/index.js"