@elitedcs/ghl-mcp 3.70.0 → 3.71.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 3.71.0 — a task you can close
+
+A subscriber's Claude created a callback task on a contact and, come Monday, could not
+close it. It said so plainly: the server can create tasks but has no way to update or
+complete one, tick it off by hand. It was right. `create_contact_task` and
+`get_contact_tasks` were the whole task surface.
+
+**Three tools close the loop.** `complete_contact_task` marks a task done, or reopens it
+with `completed: false`. `update_contact_task` changes a task's title, description, due
+date, assignee or completed state, and sends only the fields you pass, so changing a due
+date never blanks the title; an update with no fields is refused before any request goes
+out. `delete_contact_task` removes a task for good and, like every delete in this server,
+asks for `confirm: "DELETE"`. All three use the routes in
+GoHighLevel's published contacts spec and were proven live before release on a throwaway
+contact in a sandbox account: create, complete, read back completed, update, reopen,
+delete, read back gone, contact removed (`docs/proofs/2026-08-26-task-lifecycle.md`).
+
+Counts: 245 tools across 51 modules (was 242). The free read-only tier is unchanged at
+111; the three new tools are writes and answer with upgrade information there. Restart
+Claude after the update to see them.
+
 ## 3.70.0 — a clean validation now means something
 
 A subscriber built an Instagram-comment-to-DM workflow, ran `validate_workflow`, got

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 242 tools across 51 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.** 245 tools across 51 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).
 
@@ -135,7 +135,7 @@ Run setup_ghl_mcp to activate GHL Command:
   ghl_location_id: YOUR_LOCATION_ID
 ```
 
-Approve the tool call. Server validates your license, verifies your GHL credentials, writes them to a per-user config file. **Quit Claude one more time and reopen** — the full core toolset is now unlocked (242 tools total with the optional Workflow Builder Firebase add-on).
+Approve the tool call. Server validates your license, verifies your GHL credentials, writes them to a per-user config file. **Quit Claude one more time and reopen** — the full core toolset is now unlocked (245 tools total with the optional Workflow Builder Firebase add-on).
 
 ### 4. Try it
 
@@ -175,7 +175,7 @@ https://app.gohighlevel.com/v2/location/YOUR_LOCATION_ID/dashboard
 
 ## Enable the Workflow Builder
 
-The 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 187 tools work fine — you just won't have workflow/funnel/form/pipeline editing. This is the flagship feature: do this step.
+The 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 190 tools work fine — you just won't have workflow/funnel/form/pipeline editing. This is the flagship feature: do this step.
 
 **One-click capture (v3.49.0+, the supported path):**
 
@@ -269,7 +269,7 @@ Highlights (full guide: [`docs/HEADLESS.md`](docs/HEADLESS.md)):
 
 > **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)
+### CRM & Contacts (18 tools)
 
 | Tool | What It Does |
 |---|---|
@@ -283,6 +283,9 @@ Highlights (full guide: [`docs/HEADLESS.md`](docs/HEADLESS.md)):
 | `remove_contact_tags` | Remove tags from a contact |
 | `get_contact_tasks` | List tasks for a contact |
 | `create_contact_task` | Create a task on a contact |
+| `complete_contact_task` | Mark a task done (or reopen it) |
+| `update_contact_task` | Change a task's title, description, due date, assignee or state |
+| `delete_contact_task` | Delete a task from a contact |
 | `get_contact_notes` | List notes on a contact |
 | `create_contact_note` | Add a note to a contact |
 | `get_contact_appointments` | List a contact's appointments |
@@ -798,7 +801,7 @@ Source repo is private. Contributors need an invitation from `drjerryrelth`. The
 
 ### Reducing context / token usage
 
-Every registered MCP tool's schema is shipped to the model on every message. With 242 tools that's a meaningful per-message context cost even in chats that never touch GHL. If you only use a slice of GHL Command, restrict the tool surface with `GHL_ENABLED_MODULES` and/or `GHL_ENABLED_TOOLS`:
+Every registered MCP tool's schema is shipped to the model on every message. With 245 tools that's a meaningful per-message context cost even in chats that never touch GHL. If you only use a slice of GHL Command, restrict the tool surface with `GHL_ENABLED_MODULES` and/or `GHL_ENABLED_TOOLS`:
 
 ```jsonc
 // Claude Desktop config — enable whole modules

package/dist/index.js

@@ -2732,6 +2732,15 @@ var init_contact_window = __esm({
 });
 
 // src/tools/contacts.ts
+function buildUpdateTaskBody(input) {
+  const body = {};
+  if (input.title !== void 0) body.title = input.title;
+  if (input.body !== void 0) body.body = input.body;
+  if (input.dueDate !== void 0) body.dueDate = input.dueDate;
+  if (input.completed !== void 0) body.completed = input.completed;
+  if (input.assignedTo !== void 0) body.assignedTo = input.assignedTo;
+  return Object.keys(body).length === 0 ? null : body;
+}
 function registerContactTools(server2, client) {
   safeTool(
     server2,
@@ -3012,6 +3021,57 @@ function registerContactTools(server2, client) {
       });
     }
   );
+  safeTool(
+    server2,
+    "complete_contact_task",
+    "Mark a contact's task as done (or reopen it with completed=false). Find the task ID with get_contact_tasks; create_contact_task also returns it. Use this to tick off a task created earlier.",
+    {
+      contactId: import_zod9.z.string().min(1).describe("The ID of the contact the task belongs to."),
+      taskId: import_zod9.z.string().min(1).describe("The ID of the task (from get_contact_tasks or create_contact_task)."),
+      completed: import_zod9.z.boolean().optional().describe("true (default) marks the task completed; false reopens a completed task.")
+    },
+    async ({ contactId, taskId, completed }) => {
+      return client.put(`/contacts/${contactId}/tasks/${taskId}/completed`, {
+        body: { completed: completed ?? true }
+      });
+    }
+  );
+  safeTool(
+    server2,
+    "update_contact_task",
+    "Change an existing task on a contact: title, description, due date, assignee, or completed state. Only the fields you pass are changed. To simply tick a task off, complete_contact_task is the direct route.",
+    {
+      contactId: import_zod9.z.string().min(1).describe("The ID of the contact the task belongs to."),
+      taskId: import_zod9.z.string().min(1).describe("The ID of the task to update (from get_contact_tasks)."),
+      title: import_zod9.z.string().min(1).optional().describe("New title / summary of the task (cannot be blank)."),
+      body: import_zod9.z.string().optional().describe("New detailed description of the task."),
+      dueDate: import_zod9.z.string().refine((d) => !Number.isNaN(Date.parse(d)), "dueDate must be an ISO 8601 date or date-time").optional().describe("New due date in ISO 8601 format (e.g. 2026-08-31T16:00:00.000Z)."),
+      completed: import_zod9.z.boolean().optional().describe("Set the completed state of the task."),
+      assignedTo: import_zod9.z.string().optional().describe("User ID to reassign the task to.")
+    },
+    async ({ contactId, taskId, title, body: taskBody, dueDate, completed, assignedTo }) => {
+      const reqBody = buildUpdateTaskBody({ title, body: taskBody, dueDate, completed, assignedTo });
+      if (!reqBody) {
+        throw new Error(
+          "Nothing to update: pass at least one of title, body, dueDate, completed, assignedTo."
+        );
+      }
+      return client.put(`/contacts/${contactId}/tasks/${taskId}`, { body: reqBody });
+    }
+  );
+  safeTool(
+    server2,
+    "delete_contact_task",
+    "Delete a task from a contact. Permanent. To keep the record and just close it, use complete_contact_task instead.",
+    {
+      contactId: import_zod9.z.string().min(1).describe("The ID of the contact the task belongs to."),
+      taskId: import_zod9.z.string().min(1).describe("The ID of the task to delete (from get_contact_tasks)."),
+      confirm: import_zod9.z.literal("DELETE").describe("Must pass 'DELETE' to confirm this destructive action.")
+    },
+    async ({ contactId, taskId }) => {
+      return client.delete(`/contacts/${contactId}/tasks/${taskId}`);
+    }
+  );
   safeTool(
     server2,
     "get_contact_notes",
@@ -9797,7 +9857,7 @@ Note: Firebase credentials rejected (${fb.error}).`;
       const telemetryLine = telemetryDisabled(process.env) ? "" : `
 
 ${TELEMETRY_DISCLOSURE}`;
-      const finishedCount = isFree ? "111" : "242";
+      const finishedCount = isFree ? "111" : "245";
       const freeTip = isFree ? `
 
 Free tier: read-only. Write tools stay visible but answer with upgrade info instead of acting. Full version ($97/mo founding rate) upgrades in place \u2014 same install, you only swap the license key: https://ghlcommand.com` : "";
@@ -9842,7 +9902,7 @@ Free tier: read-only. Write tools stay visible but answer with upgrade info inst
 function registerEnableWorkflowBuilderTool(server2) {
   server2.tool(
     "enable_workflow_builder",
-    "Add Firebase credentials to an existing GHL Command install to unlock 55 additional tools across the internal-API modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder, form builder, pipeline builder, workflow cloner, smart lists, reputation, email campaigns, email templates, and memberships, plus the pre-deploy validator. On the FREE tier this same login unlocks the read-only auditor suite (audit_workflows, validate_workflow, full-detail workflow/funnel/pipeline reads). Requires you've already run setup_ghl_mcp. EASIEST PATH: run `capture_firebase_interactive` instead \u2014 a Chrome window opens, you log into GHL, zero pasting. Use THIS tool when you have JSON from `auto_capture_firebase_script` (console-paste path) to put in `firebase_paste`, or the three manual DevTools fields. Tool count goes from 187 to 242 after the next Claude restart.",
+    "Add Firebase credentials to an existing GHL Command install to unlock 55 additional tools across the internal-API modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder, form builder, pipeline builder, workflow cloner, smart lists, reputation, email campaigns, email templates, and memberships, plus the pre-deploy validator. On the FREE tier this same login unlocks the read-only auditor suite (audit_workflows, validate_workflow, full-detail workflow/funnel/pipeline reads). Requires you've already run setup_ghl_mcp. EASIEST PATH: run `capture_firebase_interactive` instead \u2014 a Chrome window opens, you log into GHL, zero pasting. Use THIS tool when you have JSON from `auto_capture_firebase_script` (console-paste path) to put in `firebase_paste`, or the three manual DevTools fields. Tool count goes from 190 to 245 after the next Claude restart.",
     {
       // v3.25.0: one-paste path. Tool runs `auto_capture_firebase_script` to
       // get the console script; the script returns a JSON object that pastes
@@ -18968,9 +19028,9 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.70.0",
+      version: "3.71.0",
       mcpName: "io.github.drjerryrelth/ghl-command",
-      description: "GoHighLevel MCP Server for Claude. 242 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
+      description: "GoHighLevel MCP Server for Claude. 245 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.70.0",
+  "version": "3.71.0",
   "mcpName": "io.github.drjerryrelth/ghl-command",
-  "description": "GoHighLevel MCP Server for Claude. 242 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
+  "description": "GoHighLevel MCP Server for Claude. 245 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
   "main": "dist/index.js",
   "bin": {
     "ghl-mcp": "dist/index.js"