@nightsquawktech/gohighlevel-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,172 @@
+# @nightsquawktech/gohighlevel-mcp-server
+
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/NightSquawk/gohighlevel-mcp-server/badge)](https://scorecard.dev/viewer/?uri=github.com/NightSquawk/gohighlevel-mcp-server)
+
+Stdio MCP server for curated GoHighLevel API v2 coverage. It is intended to run beside the official hosted HighLevel MCP and fill the gaps that server does not expose:
+
+- create, update, and delete custom fields
+- delete contacts
+- guarded duplicate-contact merge workaround for records that are safe to hard-delete
+
+This implementation covers all phases in `SCOPE.md`: custom fields, custom values, contacts, opportunities, tags, conversations, calendars, locations/users, contact notes/tasks, and Custom Fields V2/folders. Destructive and outbound tools (deletes, merges, message sends) require an explicit `confirm: true` parameter and should only be run with explicit human approval.
+
+## Custom Field API Fork
+
+The P1 custom-field write tools use the current location-scoped endpoints:
+
+- `PUT /locations/{locationId}/customFields/{id}`
+- `DELETE /locations/{locationId}/customFields/{id}`
+
+The newer `/custom-fields/{id}` V2 API is documented separately and says it only supports Custom Objects and Company/Business today. It is implemented as separate V2/folder tools instead of replacing the location-scoped contact/opportunity custom-field tools.
+
+## Setup
+
+Configure your MCP client to run the server with `npx`:
+
+```json
+{
+  "mcpServers": {
+    "gohighlevel": {
+      "command": "npx",
+      "args": ["-y", "@nightsquawktech/gohighlevel-mcp-server"],
+      "env": {
+        "GHL_API_TOKEN": "pit-...",
+        "GHL_LOCATION_ID": "<location id>",
+        "GHL_API_VERSION": "2021-07-28"
+      }
+    }
+  }
+}
+```
+
+## Environment
+
+- `GHL_API_TOKEN` required. Private Integration Token or OAuth sub-account access token.
+- `GHL_LOCATION_ID` required. Default sub-account/location ID.
+- `GHL_BASE_URL` optional, default `https://services.leadconnectorhq.com`.
+- `GHL_API_VERSION` optional, default `2021-07-28`.
+- `GHL_TIMEOUT_MS` optional, default `30000`.
+
+Required Private Integration scopes for the full server roadmap:
+
+- `locations/customFields.readonly`, `locations/customFields.write`
+- `locations/customValues.readonly`, `locations/customValues.write`
+- `contacts.readonly`, `contacts.write`
+- `opportunities.readonly`, `opportunities.write`
+- `conversations.readonly`, `conversations.write`
+- `conversations/message.readonly`, `conversations/message.write`
+- `calendars.readonly`, `calendars.write`
+- `calendars/events.readonly`, `calendars/events.write`
+- `locations.readonly`, `locations.write`
+- `workflows.readonly`
+
+## Tools
+
+- `ghl_list_custom_fields`
+- `ghl_get_custom_field`
+- `ghl_create_custom_field`
+- `ghl_update_custom_field`
+- `ghl_delete_custom_field` requires `confirm: true`
+- `ghl_list_custom_values`
+- `ghl_get_custom_value`
+- `ghl_create_custom_value`
+- `ghl_update_custom_value`
+- `ghl_delete_custom_value` requires `confirm: true`
+- `ghl_search_contacts`
+- `ghl_get_contact`
+- `ghl_create_contact`
+- `ghl_update_contact`
+- `ghl_upsert_contact`
+- `ghl_delete_contact` requires `confirm: true`
+- `ghl_merge_contacts_delete_loser` previews by default; requires `confirm: true`, deletes the loser only after zero-history preflight checks, then updates the survivor email
+- `ghl_add_contact_tags`
+- `ghl_remove_contact_tags` requires `confirm: true`
+- `ghl_add_contact_to_workflow`
+- `ghl_remove_contact_from_workflow` requires `confirm: true`
+- `ghl_get_contact_notes`
+- `ghl_create_contact_note`
+- `ghl_get_contact_tasks`
+- `ghl_create_contact_task`
+- `ghl_search_opportunities`
+- `ghl_get_pipelines`
+- `ghl_get_opportunity`
+- `ghl_create_opportunity`
+- `ghl_update_opportunity`
+- `ghl_update_opportunity_status`
+- `ghl_delete_opportunity` requires `confirm: true`
+- `ghl_list_tags`
+- `ghl_get_tag`
+- `ghl_create_tag`
+- `ghl_update_tag`
+- `ghl_delete_tag` requires `confirm: true`
+- `ghl_search_conversations`
+- `ghl_get_conversation_messages`
+- `ghl_send_message` requires `confirm: true`
+- `ghl_list_calendars`
+- `ghl_get_calendar_events`
+- `ghl_get_free_slots`
+- `ghl_create_appointment`
+- `ghl_update_appointment`
+- `ghl_delete_appointment` requires `confirm: true`
+- `ghl_get_location`
+- `ghl_list_users`
+- `ghl_list_custom_fields_v2`
+- `ghl_get_custom_field_v2`
+- `ghl_create_custom_field_v2`
+- `ghl_update_custom_field_v2`
+- `ghl_delete_custom_field_v2` requires `confirm: true`
+- `ghl_create_custom_field_folder`
+- `ghl_update_custom_field_folder`
+- `ghl_delete_custom_field_folder` requires `confirm: true`
+
+All tools return both text content and `structuredContent`. Read tools support `response_format: "markdown" | "json"`.
+
+## Verification
+
+Read-only smoke tests:
+
+```powershell
+$h = @{
+  Authorization = "Bearer $env:GHL_API_TOKEN"
+  Version = $env:GHL_API_VERSION ?? "2021-07-28"
+  Accept = "application/json"
+}
+Invoke-RestMethod "https://services.leadconnectorhq.com/locations/$env:GHL_LOCATION_ID/customFields" -Headers $h
+Invoke-RestMethod "https://services.leadconnectorhq.com/locations/$env:GHL_LOCATION_ID/customValues" -Headers $h
+Invoke-RestMethod "https://services.leadconnectorhq.com/locations/$env:GHL_LOCATION_ID/tags" -Headers $h
+Invoke-RestMethod "https://services.leadconnectorhq.com/contacts/search" -Method Post -Headers $h -ContentType "application/json" -Body (@{ locationId = $env:GHL_LOCATION_ID; pageLimit = 1 } | ConvertTo-Json)
+Invoke-RestMethod "https://services.leadconnectorhq.com/opportunities/pipelines?locationId=$env:GHL_LOCATION_ID" -Headers $h
+Invoke-RestMethod "https://services.leadconnectorhq.com/calendars/?locationId=$env:GHL_LOCATION_ID" -Headers $h
+Invoke-RestMethod "https://services.leadconnectorhq.com/users/?locationId=$env:GHL_LOCATION_ID" -Headers $h
+```
+
+Owner-approved write/delete test plan:
+
+1. Create a disposable custom value, read it back, update its `value`, then delete it with `confirm: true`.
+2. Create a disposable custom field named with a clear test prefix, read it back, update its placeholder, then delete it with `confirm: true`.
+3. Pick or create a disposable contact, add a disposable tag, remove the tag with `confirm: true`, then delete the contact with `confirm: true` only if the owner approves contact deletion.
+4. Add a disposable contact to a safe test workflow, then remove it with `confirm: true`.
+5. Create/update/upsert a disposable contact, then verify no production contact was modified.
+6. Create a disposable opportunity in a test pipeline/stage, update it, update its status, then delete it with `confirm: true`.
+7. Send a message only to an owner-approved test contact/channel with `confirm: true`.
+8. Create/update/delete a disposable appointment on a test calendar with `confirm: true` for delete.
+9. Create/update/delete a disposable Custom Fields V2 field and folder only under an owner-approved test object key, with `confirm: true` for deletes.
+10. Create a disposable contact note and task only on an owner-approved test contact.
+11. For each destructive tool, first call it without `confirm: true` and verify it returns an MCP error without calling GoHighLevel.
+12. For `ghl_merge_contacts_delete_loser`, first run `confirm: false` against an owner-approved duplicate pair and verify the preview shows the loser email, survivor email, and zero notes/tasks/conversations/opportunities/history-check errors. For the destructive test, use only disposable contacts: create a survivor and loser, set the loser's email, verify no history exists, run with `confirm: true`, verify the loser is gone and the survivor has the copied email. Separately verify the guard by adding a note/task to a disposable loser and confirming the merge is skipped without deletion.
+
+Use stderr only for logs. Never commit `.env` or real tokens.
+
+## Development
+
+```sh
+npm install
+npm run dev
+npm run build
+```
+
+## License
+
+Licensed under the [GNU AGPL v3.0](./LICENSE). Free for personal and open-source use.
+
+Organizations that cannot comply with the AGPL can purchase a commercial license. See [COMMERCIAL.md](./COMMERCIAL.md) or contact hello@nightsquawk.tech.

package/dist/constants.d.ts

@@ -0,0 +1,14 @@
+export declare const SERVER_NAME = "gohighlevel-mcp-server";
+export declare const SERVER_VERSION = "0.1.0";
+export declare const ENV: {
+    readonly apiToken: "GHL_API_TOKEN";
+    readonly locationId: "GHL_LOCATION_ID";
+    readonly baseUrl: "GHL_BASE_URL";
+    readonly apiVersion: "GHL_API_VERSION";
+    readonly timeoutMs: "GHL_TIMEOUT_MS";
+};
+export declare const DEFAULT_BASE_URL = "https://services.leadconnectorhq.com";
+export declare const DEFAULT_API_VERSION = "2021-07-28";
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const RESPONSE_CHARACTER_LIMIT = 25000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,2BAA2B,CAAC;AACpD,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,eAAO,MAAM,GAAG;;;;;;CAMN,CAAC;AAEX,eAAO,MAAM,gBAAgB,yCAAyC,CAAC;AACvE,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAChD,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,wBAAwB,QAAS,CAAC"}

package/dist/constants.js

@@ -0,0 +1,14 @@
+export const SERVER_NAME = "gohighlevel-mcp-server";
+export const SERVER_VERSION = "0.1.0";
+export const ENV = {
+    apiToken: "GHL_API_TOKEN",
+    locationId: "GHL_LOCATION_ID",
+    baseUrl: "GHL_BASE_URL",
+    apiVersion: "GHL_API_VERSION",
+    timeoutMs: "GHL_TIMEOUT_MS"
+};
+export const DEFAULT_BASE_URL = "https://services.leadconnectorhq.com";
+export const DEFAULT_API_VERSION = "2021-07-28";
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const RESPONSE_CHARACTER_LIMIT = 25_000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,wBAAwB,CAAC;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,iBAAiB;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,iBAAiB;IAC7B,SAAS,EAAE,gBAAgB;CACnB,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG,sCAAsC,CAAC;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SERVER_NAME, SERVER_VERSION } from "./constants.js";
+import { loadConfig } from "./services/config.js";
+import { GoHighLevelClient } from "./services/gohighlevel-client.js";
+import { registerTools } from "./tools/index.js";
+async function main() {
+    const config = loadConfig();
+    const client = new GoHighLevelClient(config);
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION
+    });
+    registerTools(server, client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`${SERVER_NAME} ${SERVER_VERSION} running on stdio`);
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,cAAc,mBAAmB,CAAC,CAAC;AACrE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/schemas/calendars.d.ts

@@ -0,0 +1,185 @@
+import { z } from "zod";
+export declare const ListCalendarsSchema: z.ZodObject<{
+    location_id: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    response_format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+}, "strict", z.ZodTypeAny, {
+    offset: number;
+    limit: number;
+    response_format: "markdown" | "json";
+    location_id?: string | undefined;
+}, {
+    offset?: number | undefined;
+    location_id?: string | undefined;
+    limit?: number | undefined;
+    response_format?: "markdown" | "json" | undefined;
+}>;
+export declare const CalendarEventsSchema: z.ZodObject<{
+    location_id: z.ZodOptional<z.ZodString>;
+    calendarId: z.ZodOptional<z.ZodString>;
+    groupId: z.ZodOptional<z.ZodString>;
+    contactId: z.ZodOptional<z.ZodString>;
+    startTime: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    endTime: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    response_format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+    extra_query: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    offset: number;
+    limit: number;
+    response_format: "markdown" | "json";
+    location_id?: string | undefined;
+    calendarId?: string | undefined;
+    groupId?: string | undefined;
+    contactId?: string | undefined;
+    startTime?: string | number | undefined;
+    endTime?: string | number | undefined;
+    extra_query?: Record<string, unknown> | undefined;
+}, {
+    offset?: number | undefined;
+    location_id?: string | undefined;
+    limit?: number | undefined;
+    response_format?: "markdown" | "json" | undefined;
+    calendarId?: string | undefined;
+    groupId?: string | undefined;
+    contactId?: string | undefined;
+    startTime?: string | number | undefined;
+    endTime?: string | number | undefined;
+    extra_query?: Record<string, unknown> | undefined;
+}>;
+export declare const FreeSlotsSchema: z.ZodObject<{
+    calendar_id: z.ZodString;
+    startDate: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    endDate: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    timezone: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    response_format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+    extra_query: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: "markdown" | "json";
+    calendar_id: string;
+    startDate: string | number;
+    endDate: string | number;
+    extra_query?: Record<string, unknown> | undefined;
+    timezone?: string | undefined;
+    userId?: string | undefined;
+}, {
+    calendar_id: string;
+    startDate: string | number;
+    endDate: string | number;
+    response_format?: "markdown" | "json" | undefined;
+    extra_query?: Record<string, unknown> | undefined;
+    timezone?: string | undefined;
+    userId?: string | undefined;
+}>;
+export declare const CreateAppointmentSchema: z.ZodObject<{
+    calendarId: z.ZodString;
+    locationId: z.ZodOptional<z.ZodString>;
+    contactId: z.ZodString;
+    startTime: z.ZodString;
+    response_format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+    endTime: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    appointmentStatus: z.ZodOptional<z.ZodString>;
+    assignedUserId: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    ignoreDateRange: z.ZodOptional<z.ZodBoolean>;
+    toNotify: z.ZodOptional<z.ZodBoolean>;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: "markdown" | "json";
+    calendarId: string;
+    contactId: string;
+    startTime: string;
+    endTime?: string | undefined;
+    locationId?: string | undefined;
+    title?: string | undefined;
+    appointmentStatus?: string | undefined;
+    assignedUserId?: string | undefined;
+    address?: string | undefined;
+    ignoreDateRange?: boolean | undefined;
+    toNotify?: boolean | undefined;
+    extra?: Record<string, unknown> | undefined;
+}, {
+    calendarId: string;
+    contactId: string;
+    startTime: string;
+    response_format?: "markdown" | "json" | undefined;
+    endTime?: string | undefined;
+    locationId?: string | undefined;
+    title?: string | undefined;
+    appointmentStatus?: string | undefined;
+    assignedUserId?: string | undefined;
+    address?: string | undefined;
+    ignoreDateRange?: boolean | undefined;
+    toNotify?: boolean | undefined;
+    extra?: Record<string, unknown> | undefined;
+}>;
+export declare const UpdateAppointmentSchema: z.ZodObject<{
+    response_format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+    calendarId: z.ZodOptional<z.ZodString>;
+    locationId: z.ZodOptional<z.ZodString>;
+    contactId: z.ZodOptional<z.ZodString>;
+    startTime: z.ZodOptional<z.ZodString>;
+    endTime: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    appointmentStatus: z.ZodOptional<z.ZodString>;
+    assignedUserId: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    ignoreDateRange: z.ZodOptional<z.ZodBoolean>;
+    toNotify: z.ZodOptional<z.ZodBoolean>;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    appointment_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    response_format: "markdown" | "json";
+    appointment_id: string;
+    calendarId?: string | undefined;
+    contactId?: string | undefined;
+    startTime?: string | undefined;
+    endTime?: string | undefined;
+    locationId?: string | undefined;
+    title?: string | undefined;
+    appointmentStatus?: string | undefined;
+    assignedUserId?: string | undefined;
+    address?: string | undefined;
+    ignoreDateRange?: boolean | undefined;
+    toNotify?: boolean | undefined;
+    extra?: Record<string, unknown> | undefined;
+}, {
+    appointment_id: string;
+    response_format?: "markdown" | "json" | undefined;
+    calendarId?: string | undefined;
+    contactId?: string | undefined;
+    startTime?: string | undefined;
+    endTime?: string | undefined;
+    locationId?: string | undefined;
+    title?: string | undefined;
+    appointmentStatus?: string | undefined;
+    assignedUserId?: string | undefined;
+    address?: string | undefined;
+    ignoreDateRange?: boolean | undefined;
+    toNotify?: boolean | undefined;
+    extra?: Record<string, unknown> | undefined;
+}>;
+export declare const DeleteAppointmentSchema: z.ZodObject<{
+    event_id: z.ZodString;
+    confirm: z.ZodBoolean;
+    response_format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: "markdown" | "json";
+    event_id: string;
+    confirm: boolean;
+}, {
+    event_id: string;
+    confirm: boolean;
+    response_format?: "markdown" | "json" | undefined;
+}>;
+export type ListCalendarsInput = z.infer<typeof ListCalendarsSchema>;
+export type CalendarEventsInput = z.infer<typeof CalendarEventsSchema>;
+export type FreeSlotsInput = z.infer<typeof FreeSlotsSchema>;
+export type CreateAppointmentInput = z.infer<typeof CreateAppointmentSchema>;
+export type UpdateAppointmentInput = z.infer<typeof UpdateAppointmentSchema>;
+export type DeleteAppointmentInput = z.infer<typeof DeleteAppointmentSchema>;
+//# sourceMappingURL=calendars.d.ts.map

package/dist/schemas/calendars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendars.d.ts","sourceRoot":"","sources":["../../src/schemas/calendars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAOrB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAatB,CAAC;AAEZ,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;EAUjB,CAAC;AAiBZ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAMzB,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC7D,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/schemas/calendars.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { ConfirmSchema, ExtraSchema, IdSchema, LimitSchema, LocationIdSchema, OffsetSchema, ResponseFormatSchema } from "./common.js";
+export const ListCalendarsSchema = z
+    .object({
+    location_id: LocationIdSchema,
+    limit: LimitSchema,
+    offset: OffsetSchema,
+    response_format: ResponseFormatSchema
+})
+    .strict();
+export const CalendarEventsSchema = z
+    .object({
+    location_id: LocationIdSchema,
+    calendarId: z.string().min(1).optional(),
+    groupId: z.string().min(1).optional(),
+    contactId: z.string().min(1).optional(),
+    startTime: z.union([z.string().min(1), z.number().int().nonnegative()]).optional().describe("Start time in milliseconds, as number or string."),
+    endTime: z.union([z.string().min(1), z.number().int().nonnegative()]).optional().describe("End time in milliseconds, as number or string."),
+    limit: LimitSchema,
+    offset: OffsetSchema,
+    response_format: ResponseFormatSchema,
+    extra_query: ExtraSchema
+})
+    .strict();
+export const FreeSlotsSchema = z
+    .object({
+    calendar_id: IdSchema.describe("Calendar ID."),
+    startDate: z.union([z.string().min(1), z.number().int().nonnegative()]).describe("Start date/time in milliseconds, as number or string."),
+    endDate: z.union([z.string().min(1), z.number().int().nonnegative()]).describe("End date/time in milliseconds, as number or string."),
+    timezone: z.string().min(1).optional(),
+    userId: z.string().min(1).optional(),
+    response_format: ResponseFormatSchema,
+    extra_query: ExtraSchema
+})
+    .strict();
+const AppointmentBodyShape = {
+    calendarId: z.string().min(1).optional(),
+    locationId: z.string().min(1).optional(),
+    contactId: z.string().min(1).optional(),
+    startTime: z.string().min(1).optional(),
+    endTime: z.string().min(1).optional(),
+    title: z.string().min(1).optional(),
+    appointmentStatus: z.string().min(1).optional(),
+    assignedUserId: z.string().min(1).optional(),
+    address: z.string().min(1).optional(),
+    ignoreDateRange: z.boolean().optional(),
+    toNotify: z.boolean().optional(),
+    extra: ExtraSchema
+};
+export const CreateAppointmentSchema = z
+    .object({
+    ...AppointmentBodyShape,
+    calendarId: z.string().min(1).describe("Calendar ID."),
+    locationId: z.string().min(1).optional().describe("Optional location ID. Defaults to GHL_LOCATION_ID when omitted."),
+    contactId: z.string().min(1).describe("Contact ID."),
+    startTime: z.string().min(1).describe("Appointment start time."),
+    response_format: ResponseFormatSchema
+})
+    .strict();
+export const UpdateAppointmentSchema = z
+    .object({
+    appointment_id: IdSchema.describe("Appointment/event ID."),
+    ...AppointmentBodyShape,
+    response_format: ResponseFormatSchema
+})
+    .strict();
+export const DeleteAppointmentSchema = z
+    .object({
+    event_id: IdSchema.describe("Calendar event ID."),
+    confirm: ConfirmSchema,
+    response_format: ResponseFormatSchema
+})
+    .strict();
+//# sourceMappingURL=calendars.js.map

package/dist/schemas/calendars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendars.js","sourceRoot":"","sources":["../../src/schemas/calendars.ts"],"names":[],"mappings":"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"}

package/dist/schemas/common.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const ResponseFormatSchema: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+export declare const LimitSchema: z.ZodDefault<z.ZodNumber>;
+export declare const OffsetSchema: z.ZodDefault<z.ZodNumber>;
+export declare const LocationIdSchema: z.ZodOptional<z.ZodString>;
+export declare const ConfirmSchema: z.ZodBoolean;
+export declare const IdSchema: z.ZodString;
+export declare const NonEmptyStringArraySchema: z.ZodArray<z.ZodString, "many">;
+export declare const ExtraSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+//# sourceMappingURL=common.d.ts.map

package/dist/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB,+CAG+D,CAAC;AAEjG,eAAO,MAAM,WAAW,2BAM6C,CAAC;AAEtE,eAAO,MAAM,YAAY,2BAKuD,CAAC;AAEjF,eAAO,MAAM,gBAAgB,4BAIyD,CAAC;AAEvF,eAAO,MAAM,aAAa,cAE+E,CAAC;AAE1G,eAAO,MAAM,QAAQ,aAAgE,CAAC;AAEtF,eAAO,MAAM,yBAAyB,iCAAoC,CAAC;AAE3E,eAAO,MAAM,WAAW,uDAGoG,CAAC"}

package/dist/schemas/common.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export const ResponseFormatSchema = z
+    .enum(["markdown", "json"])
+    .default("markdown")
+    .describe("Output format: markdown for human-readable summaries, json for structured output.");
+export const LimitSchema = z
+    .number()
+    .int()
+    .min(1)
+    .max(100)
+    .default(25)
+    .describe("Maximum number of items to return from the local page.");
+export const OffsetSchema = z
+    .number()
+    .int()
+    .min(0)
+    .default(0)
+    .describe("Number of items to skip locally after receiving the API response.");
+export const LocationIdSchema = z
+    .string()
+    .min(1)
+    .optional()
+    .describe("Optional GoHighLevel location ID override. Defaults to GHL_LOCATION_ID.");
+export const ConfirmSchema = z
+    .boolean()
+    .describe("Required for destructive tools. The API call is made only when confirm is explicitly true.");
+export const IdSchema = z.string().min(1).describe("GoHighLevel opaque resource ID.");
+export const NonEmptyStringArraySchema = z.array(z.string().min(1)).min(1);
+export const ExtraSchema = z
+    .record(z.unknown())
+    .optional()
+    .describe("Optional additional GoHighLevel fields to pass through when the API supports fields not modeled by this tool.");
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;KAC1B,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,mFAAmF,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,EAAE;KACR,GAAG,EAAE;KACL,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,OAAO,CAAC,EAAE,CAAC;KACX,QAAQ,CAAC,wDAAwD,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,EAAE;KACR,GAAG,EAAE;KACL,GAAG,CAAC,CAAC,CAAC;KACN,OAAO,CAAC,CAAC,CAAC;KACV,QAAQ,CAAC,mEAAmE,CAAC,CAAC;AAEjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,EAAE;KACV,QAAQ,CAAC,yEAAyE,CAAC,CAAC;AAEvF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,OAAO,EAAE;KACT,QAAQ,CAAC,4FAA4F,CAAC,CAAC;AAE1G,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;AAEtF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;KACnB,QAAQ,EAAE;KACV,QAAQ,CAAC,+GAA+G,CAAC,CAAC"}