ghl-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Quentin Daems
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+# GHL CLI 🚀
+
+Command-line interface for [GoHighLevel](https://gohighlevel.com) CRM via MCP.
+
+Manage contacts, conversations, calendar, opportunities, and payments from your terminal.
+
+## Installation
+
+```bash
+npm install -g ghl-cli
+```
+
+## Setup
+
+```bash
+ghl auth
+```
+
+You'll need:
+1. **Private Integration Token (PIT)** - from Settings > Private Integrations in GHL
+2. **Location ID** - your sub-account ID
+
+## Usage
+
+### Contacts
+
+```bash
+ghl contacts list              # List contacts
+ghl contacts get <id>          # Get contact details
+ghl contacts create --name "John Doe" --email john@example.com
+ghl contacts tag <id> lead hot # Add tags
+ghl contacts tasks <id>        # Get tasks for contact
+```
+
+### Conversations
+
+```bash
+ghl conv search                # Search conversations
+ghl conv messages <id>         # Get messages
+ghl conv send <id> "Hello!"    # Send SMS
+ghl conv send <id> "Hello!" --type Email
+```
+
+### Calendar
+
+```bash
+ghl cal events                 # List calendar events
+ghl cal notes <appointmentId>  # Get appointment notes
+```
+
+### Opportunities
+
+```bash
+ghl opp pipelines              # List pipelines
+ghl opp search                 # Search opportunities
+ghl opp get <id>               # Get opportunity details
+ghl opp update <id> --status won --value 5000
+```
+
+### Payments
+
+```bash
+ghl pay transactions           # List transactions
+ghl pay order <id>             # Get order details
+```
+
+### Location
+
+```bash
+ghl loc info                   # Get location details
+ghl loc fields                 # List custom fields
+```
+
+## Environment Variables
+
+Instead of `ghl auth`, you can set:
+```bash
+export GHL_TOKEN="pit-xxxxx"
+export GHL_LOCATION_ID="xxxxx"
+```
+
+## License
+
+MIT © [Quentin Daems](https://shvz.fr)
+
+## Credits
+
+Built with [LoopShip](https://github.com/nexty5870/loopship) 🚀
+Uses [GoHighLevel MCP](https://marketplace.gohighlevel.com/docs/other/mcp/)

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "ghl-cli",
+  "version": "0.1.0",
+  "description": "CLI for GoHighLevel CRM via MCP",
+  "type": "module",
+  "bin": {
+    "ghl": "./src/cli.js"
+  },
+  "files": ["src", "README.md", "LICENSE"],
+  "scripts": {
+    "start": "node src/cli.js"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0"
+  },
+  "keywords": ["gohighlevel", "ghl", "crm", "cli", "mcp"],
+  "author": "Quentin Daems <quentin@shvz.fr>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nexty5870/ghl-cli.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/cli.js

@@ -0,0 +1,504 @@
+#!/usr/bin/env node
+/**
+ * GHL CLI - Command-line interface for GoHighLevel CRM
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import { createInterface } from "readline";
+import { createClient, GHLClient } from "./lib/mcp.js";
+import { getToken, getLocationId, setCredentials, clearCredentials, getConfigPath } from "./lib/config.js";
+
+const program = new Command();
+
+program
+  .name("ghl")
+  .description("CLI for GoHighLevel CRM via MCP")
+  .version("0.1.0");
+
+// ============ AUTH ============
+program
+  .command("auth")
+  .description("Set up your GHL credentials")
+  .option("--clear", "Remove saved credentials")
+  .option("--show", "Show current auth status")
+  .action(async (options) => {
+    if (options.clear) {
+      clearCredentials();
+      console.log(chalk.green("✅ Credentials removed."));
+      return;
+    }
+
+    if (options.show) {
+      const token = getToken();
+      const locationId = getLocationId();
+      if (token && locationId) {
+        console.log(chalk.green(`✅ Configured`));
+        console.log(chalk.gray(`   Token: ${token.slice(0, 10)}...`));
+        console.log(chalk.gray(`   Location: ${locationId}`));
+        console.log(chalk.gray(`   Config: ${getConfigPath()}`));
+      } else {
+        console.log(chalk.yellow("⚠️  Not configured. Run 'ghl auth' to set up."));
+      }
+      return;
+    }
+
+    console.log(chalk.cyan("\n🔐 GoHighLevel Setup\n"));
+    console.log(chalk.white("To get your Private Integration Token (PIT):"));
+    console.log(chalk.gray("  1. Go to Settings > Private Integrations in GHL"));
+    console.log(chalk.gray("  2. Create New Integration with required scopes"));
+    console.log(chalk.gray("  3. Copy the generated token\n"));
+
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const question = (prompt) => new Promise((resolve) => rl.question(prompt, resolve));
+
+    try {
+      const token = await question(chalk.yellow("Paste your PIT token: "));
+      const locationId = await question(chalk.yellow("Paste your Location ID: "));
+      rl.close();
+
+      if (!token || !locationId) {
+        console.log(chalk.red("\n❌ Both token and location ID are required."));
+        process.exit(1);
+      }
+
+      console.log(chalk.gray("\nVerifying credentials..."));
+      const client = new GHLClient(token.trim(), locationId.trim());
+      
+      try {
+        await client.getLocation();
+        setCredentials(token.trim(), locationId.trim());
+        console.log(chalk.green("\n✅ Credentials verified and saved!"));
+        console.log(chalk.cyan("\nTry 'ghl contacts list' to see your contacts."));
+      } catch (e) {
+        console.log(chalk.red(`\n❌ Verification failed: ${e.message}`));
+        process.exit(1);
+      }
+    } catch (e) {
+      rl.close();
+      console.log(chalk.red(`\nError: ${e.message}`));
+      process.exit(1);
+    }
+  });
+
+// ============ CONTACTS ============
+const contacts = program.command("contacts").description("Manage contacts");
+
+contacts
+  .command("list")
+  .description("List contacts")
+  .option("-l, --limit <n>", "Number of contacts", "20")
+  .option("-q, --query <text>", "Search query")
+  .action(async (options) => {
+    try {
+      const client = createClient();
+      const data = await client.getContacts({ 
+        limit: parseInt(options.limit),
+        query: options.query 
+      });
+      
+      console.log(chalk.cyan("\n👥 Contacts:\n"));
+      const contacts = data.contacts || data || [];
+      
+      if (!contacts.length) {
+        console.log(chalk.yellow("No contacts found."));
+        return;
+      }
+
+      for (const c of contacts) {
+        console.log(chalk.white(`  ${chalk.bold(c.id?.slice(0, 8) || "?")}  ${c.firstName || ""} ${c.lastName || ""}`));
+        console.log(chalk.gray(`           ${c.email || ""} • ${c.phone || ""}\n`));
+      }
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+contacts
+  .command("get <id>")
+  .description("Get contact details")
+  .action(async (id) => {
+    try {
+      const client = createClient();
+      const contact = await client.getContact(id);
+      
+      console.log(chalk.cyan(`\n👤 Contact: ${contact.firstName || ""} ${contact.lastName || ""}\n`));
+      console.log(chalk.white(`  ID:       ${contact.id}`));
+      console.log(chalk.white(`  Email:    ${contact.email || "-"}`));
+      console.log(chalk.white(`  Phone:    ${contact.phone || "-"}`));
+      console.log(chalk.white(`  Tags:     ${contact.tags?.join(", ") || "-"}`));
+      console.log(chalk.white(`  Created:  ${contact.dateAdded || "-"}`));
+      console.log();
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+contacts
+  .command("create")
+  .description("Create a new contact")
+  .requiredOption("--name <name>", "Full name")
+  .option("--email <email>", "Email address")
+  .option("--phone <phone>", "Phone number")
+  .action(async (options) => {
+    try {
+      const client = createClient();
+      const [firstName, ...rest] = options.name.split(" ");
+      const lastName = rest.join(" ");
+      
+      const contact = await client.createContact({
+        firstName,
+        lastName,
+        email: options.email,
+        phone: options.phone
+      });
+      
+      console.log(chalk.green(`\n✅ Contact created: ${contact.id}`));
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+contacts
+  .command("tag <id> <tags...>")
+  .description("Add tags to a contact")
+  .action(async (id, tags) => {
+    try {
+      const client = createClient();
+      await client.addTags(id, tags);
+      console.log(chalk.green(`\n✅ Added tags: ${tags.join(", ")}`));
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+contacts
+  .command("tasks <id>")
+  .description("Get tasks for a contact")
+  .action(async (id) => {
+    try {
+      const client = createClient();
+      const data = await client.getTasks(id);
+      
+      console.log(chalk.cyan("\n📋 Tasks:\n"));
+      const tasks = data.tasks || data || [];
+      
+      for (const t of tasks) {
+        const status = t.completed ? "✅" : "⏳";
+        console.log(chalk.white(`  ${status} ${t.title || t.body}`));
+        if (t.dueDate) console.log(chalk.gray(`     Due: ${t.dueDate}`));
+      }
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+// ============ CONVERSATIONS ============
+const conversations = program.command("conversations").alias("conv").description("Manage conversations");
+
+conversations
+  .command("search [query]")
+  .description("Search conversations")
+  .option("-l, --limit <n>", "Number of results", "20")
+  .action(async (query, options) => {
+    try {
+      const client = createClient();
+      const data = await client.searchConversations({ 
+        query,
+        limit: parseInt(options.limit)
+      });
+      
+      console.log(chalk.cyan("\n💬 Conversations:\n"));
+      const convs = data.conversations || data || [];
+      
+      for (const c of convs) {
+        console.log(chalk.white(`  ${chalk.bold(c.id?.slice(0, 8) || "?")}  ${c.contactName || c.fullName || "Unknown"}`));
+        console.log(chalk.gray(`           ${c.lastMessageType || ""} • ${c.lastMessageDate || ""}\n`));
+      }
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+conversations
+  .command("messages <id>")
+  .description("Get messages in a conversation")
+  .action(async (id) => {
+    try {
+      const client = createClient();
+      const data = await client.getMessages(id);
+      
+      console.log(chalk.cyan("\n📨 Messages:\n"));
+      const messages = data.messages || data || [];
+      
+      for (const m of messages) {
+        const dir = m.direction === "inbound" ? "←" : "→";
+        const color = m.direction === "inbound" ? chalk.blue : chalk.green;
+        console.log(color(`  ${dir} [${m.dateAdded || ""}] ${m.body || m.message || ""}`));
+      }
+      console.log();
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+conversations
+  .command("send <id> <message...>")
+  .description("Send a message")
+  .option("-t, --type <type>", "Message type (SMS, Email)", "SMS")
+  .action(async (id, messageParts, options) => {
+    try {
+      const client = createClient();
+      const message = messageParts.join(" ");
+      await client.sendMessage(id, message, options.type);
+      console.log(chalk.green(`\n✅ Message sent!`));
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+// ============ CALENDAR ============
+const calendar = program.command("calendar").alias("cal").description("Calendar and appointments");
+
+calendar
+  .command("events")
+  .description("List calendar events")
+  .option("--user <userId>", "Filter by user ID")
+  .option("--calendar <calendarId>", "Filter by calendar ID")
+  .action(async (options) => {
+    try {
+      const client = createClient();
+      const data = await client.getCalendarEvents({
+        userId: options.user,
+        calendarId: options.calendar
+      });
+      
+      console.log(chalk.cyan("\n📅 Events:\n"));
+      const events = data.events || data || [];
+      
+      for (const e of events) {
+        console.log(chalk.white(`  ${chalk.bold(e.id?.slice(0, 8) || "?")}  ${e.title || e.name || "Untitled"}`));
+        console.log(chalk.gray(`           ${e.startTime || ""} - ${e.endTime || ""}\n`));
+      }
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+calendar
+  .command("notes <appointmentId>")
+  .description("Get appointment notes")
+  .action(async (appointmentId) => {
+    try {
+      const client = createClient();
+      const data = await client.getAppointmentNotes(appointmentId);
+      
+      console.log(chalk.cyan("\n📝 Notes:\n"));
+      const notes = data.notes || data || [];
+      
+      for (const n of notes) {
+        console.log(chalk.white(`  ${n.body || n.content || n}`));
+        console.log();
+      }
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+// ============ OPPORTUNITIES ============
+const opportunities = program.command("opportunities").alias("opp").description("Manage opportunities");
+
+opportunities
+  .command("pipelines")
+  .description("List pipelines")
+  .action(async () => {
+    try {
+      const client = createClient();
+      const data = await client.getPipelines();
+      
+      console.log(chalk.cyan("\n🔄 Pipelines:\n"));
+      const pipelines = data.pipelines || data || [];
+      
+      for (const p of pipelines) {
+        console.log(chalk.white(`  ${chalk.bold(p.id?.slice(0, 8) || "?")}  ${p.name}`));
+        if (p.stages?.length) {
+          for (const s of p.stages) {
+            console.log(chalk.gray(`           └─ ${s.name}`));
+          }
+        }
+        console.log();
+      }
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+opportunities
+  .command("search [query]")
+  .description("Search opportunities")
+  .action(async (query) => {
+    try {
+      const client = createClient();
+      const data = await client.searchOpportunities({ query });
+      
+      console.log(chalk.cyan("\n💰 Opportunities:\n"));
+      const opps = data.opportunities || data || [];
+      
+      for (const o of opps) {
+        const value = o.monetaryValue ? `$${o.monetaryValue}` : "";
+        console.log(chalk.white(`  ${chalk.bold(o.id?.slice(0, 8) || "?")}  ${o.name || o.title || "Untitled"} ${chalk.green(value)}`));
+        console.log(chalk.gray(`           ${o.pipelineStageId || o.status || ""}\n`));
+      }
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+opportunities
+  .command("get <id>")
+  .description("Get opportunity details")
+  .action(async (id) => {
+    try {
+      const client = createClient();
+      const opp = await client.getOpportunity(id);
+      
+      console.log(chalk.cyan(`\n💰 Opportunity: ${opp.name || opp.title || "Untitled"}\n`));
+      console.log(chalk.white(`  ID:       ${opp.id}`));
+      console.log(chalk.white(`  Value:    $${opp.monetaryValue || 0}`));
+      console.log(chalk.white(`  Status:   ${opp.status || "-"}`));
+      console.log(chalk.white(`  Contact:  ${opp.contactId || "-"}`));
+      console.log();
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+opportunities
+  .command("update <id>")
+  .description("Update opportunity")
+  .option("--stage <stageId>", "Move to stage")
+  .option("--value <amount>", "Set monetary value")
+  .option("--status <status>", "Set status (open, won, lost)")
+  .action(async (id, options) => {
+    try {
+      const client = createClient();
+      const updates = {};
+      if (options.stage) updates.pipelineStageId = options.stage;
+      if (options.value) updates.monetaryValue = parseFloat(options.value);
+      if (options.status) updates.status = options.status;
+      
+      await client.updateOpportunity(id, updates);
+      console.log(chalk.green(`\n✅ Opportunity updated!`));
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+// ============ PAYMENTS ============
+const payments = program.command("payments").alias("pay").description("Payments and transactions");
+
+payments
+  .command("transactions")
+  .description("List transactions")
+  .option("-l, --limit <n>", "Number of transactions", "20")
+  .action(async (options) => {
+    try {
+      const client = createClient();
+      const data = await client.listTransactions({ limit: parseInt(options.limit) });
+      
+      console.log(chalk.cyan("\n💳 Transactions:\n"));
+      const txns = data.transactions || data || [];
+      
+      for (const t of txns) {
+        const amount = t.amount ? `$${t.amount}` : "";
+        const status = t.status === "succeeded" ? chalk.green("✓") : chalk.yellow(t.status || "");
+        console.log(chalk.white(`  ${status} ${chalk.bold(t.id?.slice(0, 8) || "?")}  ${amount}`));
+        console.log(chalk.gray(`           ${t.createdAt || ""}\n`));
+      }
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+payments
+  .command("order <id>")
+  .description("Get order details")
+  .action(async (id) => {
+    try {
+      const client = createClient();
+      const order = await client.getOrder(id);
+      
+      console.log(chalk.cyan(`\n🧾 Order: ${order.id}\n`));
+      console.log(chalk.white(`  Amount:   $${order.amount || 0}`));
+      console.log(chalk.white(`  Status:   ${order.status || "-"}`));
+      console.log(chalk.white(`  Contact:  ${order.contactId || "-"}`));
+      console.log(chalk.white(`  Created:  ${order.createdAt || "-"}`));
+      console.log();
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+// ============ LOCATION ============
+const location = program.command("location").alias("loc").description("Location/sub-account info");
+
+location
+  .command("info")
+  .description("Get location details")
+  .action(async () => {
+    try {
+      const client = createClient();
+      const loc = await client.getLocation();
+      
+      console.log(chalk.cyan(`\n🏢 Location: ${loc.name || "Unnamed"}\n`));
+      console.log(chalk.white(`  ID:       ${loc.id}`));
+      console.log(chalk.white(`  Email:    ${loc.email || "-"}`));
+      console.log(chalk.white(`  Phone:    ${loc.phone || "-"}`));
+      console.log(chalk.white(`  Address:  ${loc.address || "-"}`));
+      console.log(chalk.white(`  Timezone: ${loc.timezone || "-"}`));
+      console.log();
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+location
+  .command("fields")
+  .description("List custom fields")
+  .action(async () => {
+    try {
+      const client = createClient();
+      const data = await client.getCustomFields();
+      
+      console.log(chalk.cyan("\n📋 Custom Fields:\n"));
+      const fields = data.customFields || data || [];
+      
+      for (const f of fields) {
+        console.log(chalk.white(`  ${chalk.bold(f.id?.slice(0, 8) || "?")}  ${f.name}`));
+        console.log(chalk.gray(`           Type: ${f.dataType || f.type || "-"}\n`));
+      }
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+// Default to help if no command
+program.parse();

package/src/lib/config.js

@@ -0,0 +1,51 @@
+/**
+ * Config management for GHL CLI
+ */
+
+import { homedir } from "os";
+import { join } from "path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+
+const CONFIG_DIR = join(homedir(), ".config", "ghl");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+
+export function getConfigPath() {
+  return CONFIG_FILE;
+}
+
+export function loadConfig() {
+  try {
+    if (existsSync(CONFIG_FILE)) {
+      return JSON.parse(readFileSync(CONFIG_FILE, "utf8"));
+    }
+  } catch (e) {}
+  return {};
+}
+
+export function saveConfig(config) {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+export function getToken() {
+  if (process.env.GHL_TOKEN) return process.env.GHL_TOKEN;
+  return loadConfig().token;
+}
+
+export function getLocationId() {
+  if (process.env.GHL_LOCATION_ID) return process.env.GHL_LOCATION_ID;
+  return loadConfig().locationId;
+}
+
+export function setCredentials(token, locationId) {
+  const config = loadConfig();
+  config.token = token;
+  config.locationId = locationId;
+  saveConfig(config);
+}
+
+export function clearCredentials() {
+  saveConfig({});
+}

package/src/lib/mcp.js

@@ -0,0 +1,152 @@
+/**
+ * GoHighLevel MCP Client
+ * Communicates with GHL's MCP server via HTTP Streamable protocol
+ */
+
+import { getToken, getLocationId } from "./config.js";
+
+const MCP_URL = "https://services.leadconnectorhq.com/mcp/";
+
+export class GHLClient {
+  constructor(token, locationId) {
+    this.token = token || getToken();
+    this.locationId = locationId || getLocationId();
+    
+    if (!this.token) {
+      throw new Error("No GHL token found. Run 'ghl auth' to set up.");
+    }
+    if (!this.locationId) {
+      throw new Error("No location ID found. Run 'ghl auth' to set up.");
+    }
+  }
+
+  async callTool(toolName, args = {}) {
+    // MCP uses JSON-RPC style requests
+    const request = {
+      jsonrpc: "2.0",
+      id: Date.now(),
+      method: "tools/call",
+      params: {
+        name: toolName,
+        arguments: args
+      }
+    };
+
+    const response = await fetch(MCP_URL, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${this.token}`,
+        "locationId": this.locationId
+      },
+      body: JSON.stringify(request)
+    });
+
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`GHL MCP error (${response.status}): ${text}`);
+    }
+
+    const data = await response.json();
+    
+    if (data.error) {
+      throw new Error(`MCP error: ${data.error.message || JSON.stringify(data.error)}`);
+    }
+
+    return data.result?.content?.[0]?.text ? JSON.parse(data.result.content[0].text) : data.result;
+  }
+
+  // Contacts
+  async getContacts(query = {}) {
+    return this.callTool("contacts_get-contacts", query);
+  }
+
+  async getContact(contactId) {
+    return this.callTool("contacts_get-contact", { contactId });
+  }
+
+  async createContact(data) {
+    return this.callTool("contacts_create-contact", data);
+  }
+
+  async updateContact(contactId, data) {
+    return this.callTool("contacts_update-contact", { contactId, ...data });
+  }
+
+  async addTags(contactId, tags) {
+    return this.callTool("contacts_add-tags", { contactId, tags });
+  }
+
+  async removeTags(contactId, tags) {
+    return this.callTool("contacts_remove-tags", { contactId, tags });
+  }
+
+  async getTasks(contactId) {
+    return this.callTool("contacts_get-all-tasks", { contactId });
+  }
+
+  // Conversations
+  async searchConversations(query = {}) {
+    return this.callTool("conversations_search-conversation", query);
+  }
+
+  async getMessages(conversationId) {
+    return this.callTool("conversations_get-messages", { conversationId });
+  }
+
+  async sendMessage(conversationId, message, type = "SMS") {
+    return this.callTool("conversations_send-a-new-message", { 
+      conversationId, 
+      message,
+      type
+    });
+  }
+
+  // Calendar
+  async getCalendarEvents(params = {}) {
+    return this.callTool("calendars_get-calendar-events", params);
+  }
+
+  async getAppointmentNotes(appointmentId) {
+    return this.callTool("calendars_get-appointment-notes", { appointmentId });
+  }
+
+  // Opportunities
+  async getPipelines() {
+    return this.callTool("opportunities_get-pipelines", {});
+  }
+
+  async searchOpportunities(query = {}) {
+    return this.callTool("opportunities_search-opportunity", query);
+  }
+
+  async getOpportunity(opportunityId) {
+    return this.callTool("opportunities_get-opportunity", { id: opportunityId });
+  }
+
+  async updateOpportunity(opportunityId, data) {
+    return this.callTool("opportunities_update-opportunity", { id: opportunityId, ...data });
+  }
+
+  // Payments
+  async listTransactions(params = {}) {
+    return this.callTool("payments_list-transactions", params);
+  }
+
+  async getOrder(orderId) {
+    return this.callTool("payments_get-order-by-id", { orderId });
+  }
+
+  // Location
+  async getLocation() {
+    return this.callTool("locations_get-location", { locationId: this.locationId });
+  }
+
+  async getCustomFields() {
+    return this.callTool("locations_get-custom-fields", { locationId: this.locationId });
+  }
+}
+
+export function createClient() {
+  return new GHLClient();
+}