@vineethnkrishnan/hubspot-mcp 0.1.1

package/build/common/types.d.ts

@@ -0,0 +1,10 @@
+export interface HubSpotConfig {
+    accessToken: string;
+}
+export interface McpToolResponse {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}

package/build/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/common/types.js.map

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

package/build/common/utils.d.ts

@@ -0,0 +1,29 @@
+import { McpToolResponse } from "./types";
+/**
+ * Flattens HubSpot's nested properties object to top-level fields.
+ * Input:  { id: "123", properties: { firstname: "John", lastname: "Doe" }, ... }
+ * Output: { id: "123", firstname: "John", lastname: "Doe" }
+ */
+export declare function flattenProperties(record: unknown): unknown;
+/**
+ * Removes HubSpot internal metadata keys that waste LLM tokens.
+ */
+export declare function stripHubSpotMetadata(obj: unknown, keys?: string[]): unknown;
+/**
+ * Simplifies HubSpot association responses from verbose objects to ID arrays.
+ * Input:  { associations: { companies: { results: [{ id: "456", type: "contact_to_company" }] } } }
+ * Output: { associatedCompanyIds: ["456"] } merged into the record
+ */
+export declare function simplifyAssociations(record: unknown): unknown;
+/**
+ * Composes all HubSpot-specific transformations for LLM optimization.
+ */
+export declare function transformHubSpotResponse(data: unknown): unknown;
+/**
+ * Transforms HubSpot data and wraps it in the MCP tool response format.
+ */
+export declare function formatMcpResponse(data: unknown): McpToolResponse;
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+export declare function formatMcpError(error: unknown): McpToolResponse;

package/build/common/utils.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenProperties = flattenProperties;
+exports.stripHubSpotMetadata = stripHubSpotMetadata;
+exports.simplifyAssociations = simplifyAssociations;
+exports.transformHubSpotResponse = transformHubSpotResponse;
+exports.formatMcpResponse = formatMcpResponse;
+exports.formatMcpError = formatMcpError;
+const HUBSPOT_STRIP_KEYS = [
+    "archived",
+    "archivedAt",
+    "propertiesWithHistory",
+    "properties_with_history",
+    "createdAt",
+    "updatedAt",
+];
+/**
+ * Flattens HubSpot's nested properties object to top-level fields.
+ * Input:  { id: "123", properties: { firstname: "John", lastname: "Doe" }, ... }
+ * Output: { id: "123", firstname: "John", lastname: "Doe" }
+ */
+function flattenProperties(record) {
+    if (record === null || record === undefined)
+        return record;
+    if (Array.isArray(record))
+        return record.map(flattenProperties);
+    if (typeof record !== "object")
+        return record;
+    const obj = record;
+    if (!("properties" in obj) || typeof obj.properties !== "object" || obj.properties === null) {
+        return record;
+    }
+    const { properties, ...rest } = obj;
+    return { ...rest, ...properties };
+}
+/**
+ * Removes HubSpot internal metadata keys that waste LLM tokens.
+ */
+function stripHubSpotMetadata(obj, keys = HUBSPOT_STRIP_KEYS) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map((item) => stripHubSpotMetadata(item, keys));
+    if (typeof obj !== "object")
+        return obj;
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (keys.includes(key))
+            continue;
+        result[key] = stripHubSpotMetadata(value, keys);
+    }
+    return result;
+}
+/**
+ * Simplifies HubSpot association responses from verbose objects to ID arrays.
+ * Input:  { associations: { companies: { results: [{ id: "456", type: "contact_to_company" }] } } }
+ * Output: { associatedCompanyIds: ["456"] } merged into the record
+ */
+function simplifyAssociations(record) {
+    if (record === null || record === undefined)
+        return record;
+    if (Array.isArray(record))
+        return record.map(simplifyAssociations);
+    if (typeof record !== "object")
+        return record;
+    const obj = record;
+    if (!("associations" in obj) ||
+        typeof obj.associations !== "object" ||
+        obj.associations === null) {
+        return record;
+    }
+    const { associations, ...rest } = obj;
+    const simplified = {};
+    for (const [objectType, data] of Object.entries(associations)) {
+        if (data && typeof data === "object" && "results" in data) {
+            const results = data.results;
+            if (Array.isArray(results)) {
+                const capitalizedType = objectType.charAt(0).toUpperCase() + objectType.slice(1);
+                simplified[`associated${capitalizedType}Ids`] = results.map((r) => String(r.id));
+            }
+        }
+    }
+    return { ...rest, ...simplified };
+}
+/**
+ * Composes all HubSpot-specific transformations for LLM optimization.
+ */
+function transformHubSpotResponse(data) {
+    let result = flattenProperties(data);
+    result = stripHubSpotMetadata(result);
+    result = simplifyAssociations(result);
+    return result;
+}
+/**
+ * Transforms HubSpot data and wraps it in the MCP tool response format.
+ */
+function formatMcpResponse(data) {
+    const transformed = transformHubSpotResponse(data);
+    return {
+        content: [{ type: "text", text: JSON.stringify(transformed, null, 2) }],
+    };
+}
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+function formatMcpError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/build/common/utils.js.map

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

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const zod_1 = require("zod");
+const hubspot_service_1 = require("./services/hubspot.service");
+const contact_tools_1 = require("./tools/contact.tools");
+const deal_tools_1 = require("./tools/deal.tools");
+const company_tools_1 = require("./tools/company.tools");
+// Validate required config
+const HUBSPOT_ACCESS_TOKEN = process.env.HUBSPOT_ACCESS_TOKEN;
+if (!HUBSPOT_ACCESS_TOKEN) {
+    console.error("HUBSPOT_ACCESS_TOKEN environment variable is required.");
+    process.exit(1);
+}
+const hubspotService = new hubspot_service_1.HubSpotService({
+    accessToken: HUBSPOT_ACCESS_TOKEN,
+});
+// Initialize tool classes
+const tools = {
+    contacts: new contact_tools_1.ContactTools(hubspotService),
+    deals: new deal_tools_1.DealTools(hubspotService),
+    companies: new company_tools_1.CompanyTools(hubspotService),
+};
+// Combine all schemas
+const AllToolSchemas = {
+    ...contact_tools_1.ContactToolSchemas,
+    ...deal_tools_1.DealToolSchemas,
+    ...company_tools_1.CompanyToolSchemas,
+};
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { version } = require("../package.json");
+const server = new index_js_1.Server({
+    name: "hubspot-mcp",
+    version,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+/**
+ * Handler for listing available tools.
+ */
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: Object.entries(AllToolSchemas).map(([name, config]) => ({
+            name,
+            description: config.description,
+            inputSchema: zod_1.z.toJSONSchema(config.schema),
+        })),
+    };
+});
+const toolRegistry = {};
+for (const name of Object.keys(contact_tools_1.ContactToolSchemas)) {
+    toolRegistry[name] = (args) => tools.contacts[name](args);
+}
+for (const name of Object.keys(deal_tools_1.DealToolSchemas)) {
+    toolRegistry[name] = (args) => tools.deals[name](args);
+}
+for (const name of Object.keys(company_tools_1.CompanyToolSchemas)) {
+    toolRegistry[name] = (args) => tools.companies[name](args);
+}
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        const handler = toolRegistry[name];
+        if (!handler) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Tool not found: ${name}`);
+        }
+        return await handler(args ?? {});
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+/**
+ * Start the server using Stdio transport.
+ */
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("HubSpot MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/services/hubspot.service.d.ts

@@ -0,0 +1,16 @@
+import { HubSpotConfig } from "../common/types";
+export declare class HubSpotService {
+    private baseUrl;
+    private accessToken;
+    constructor(config: HubSpotConfig);
+    private request;
+    private postRequest;
+    private handleErrorResponse;
+    listContacts(limit?: number, properties?: string[], after?: string): Promise<unknown>;
+    getContact(contactId: string, properties?: string[], associations?: string[]): Promise<unknown>;
+    searchContacts(query: string, properties?: string[], limit?: number): Promise<unknown>;
+    listDeals(limit?: number, properties?: string[], after?: string): Promise<unknown>;
+    getDeal(dealId: string, properties?: string[], associations?: string[]): Promise<unknown>;
+    listCompanies(limit?: number, properties?: string[], after?: string): Promise<unknown>;
+    getCompany(companyId: string, properties?: string[], associations?: string[]): Promise<unknown>;
+}

package/build/services/hubspot.service.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HubSpotService = void 0;
+const DEFAULT_CONTACT_PROPERTIES = [
+    "firstname",
+    "lastname",
+    "email",
+    "phone",
+    "company",
+    "lifecyclestage",
+    "hs_lead_status",
+];
+const DEFAULT_DEAL_PROPERTIES = [
+    "dealname",
+    "amount",
+    "dealstage",
+    "pipeline",
+    "closedate",
+    "hs_lastmodifieddate",
+];
+const DEFAULT_COMPANY_PROPERTIES = [
+    "name",
+    "domain",
+    "industry",
+    "city",
+    "state",
+    "phone",
+    "numberofemployees",
+];
+class HubSpotService {
+    baseUrl = "https://api.hubapi.com";
+    accessToken;
+    constructor(config) {
+        this.accessToken = config.accessToken;
+    }
+    // ===========================================================================
+    // HTTP methods
+    // ===========================================================================
+    async request(path, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value === undefined || value === null)
+                    continue;
+                if (Array.isArray(value)) {
+                    for (const item of value) {
+                        url.searchParams.append(key, item);
+                    }
+                }
+                else if (value !== "") {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const response = await fetch(url.toString(), {
+            headers: {
+                Authorization: `Bearer ${this.accessToken}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => "");
+            this.handleErrorResponse(response.status, response.statusText, errorBody, response.headers);
+        }
+        return response.json();
+    }
+    async postRequest(path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.accessToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => "");
+            this.handleErrorResponse(response.status, response.statusText, errorBody, response.headers);
+        }
+        return response.json();
+    }
+    handleErrorResponse(status, statusText, errorBody, headers) {
+        switch (status) {
+            case 401:
+                throw new Error("Authentication failed. Check your HUBSPOT_ACCESS_TOKEN.");
+            case 403:
+                throw new Error("Access denied. Token may lack required scopes (crm.objects.contacts.read, crm.objects.deals.read).");
+            case 404:
+                throw new Error("Not found. Check the ID and ensure you have access.");
+            case 429: {
+                const retryAfter = headers.get("Retry-After") ?? "unknown";
+                throw new Error(`Rate limited by HubSpot (100 requests/10 seconds). Retry after ${retryAfter} seconds.`);
+            }
+            default:
+                throw new Error(`HubSpot API error (${status}): ${errorBody || statusText}`);
+        }
+    }
+    // ===========================================================================
+    // Contacts
+    // ===========================================================================
+    async listContacts(limit, properties, after) {
+        const resolvedProperties = properties ?? DEFAULT_CONTACT_PROPERTIES;
+        const params = {
+            limit: String(limit ?? 10),
+            properties: resolvedProperties,
+        };
+        if (after)
+            params.after = after;
+        return this.request("/crm/v3/objects/contacts", params);
+    }
+    async getContact(contactId, properties, associations) {
+        const resolvedProperties = properties ?? DEFAULT_CONTACT_PROPERTIES;
+        const params = {
+            properties: resolvedProperties,
+        };
+        if (associations)
+            params.associations = associations;
+        return this.request(`/crm/v3/objects/contacts/${contactId}`, params);
+    }
+    async searchContacts(query, properties, limit) {
+        const body = {
+            query,
+            properties: properties ?? DEFAULT_CONTACT_PROPERTIES,
+            limit: limit ?? 10,
+        };
+        return this.postRequest("/crm/v3/objects/contacts/search", body);
+    }
+    // ===========================================================================
+    // Deals
+    // ===========================================================================
+    async listDeals(limit, properties, after) {
+        const resolvedProperties = properties ?? DEFAULT_DEAL_PROPERTIES;
+        const params = {
+            limit: String(limit ?? 10),
+            properties: resolvedProperties,
+        };
+        if (after)
+            params.after = after;
+        return this.request("/crm/v3/objects/deals", params);
+    }
+    async getDeal(dealId, properties, associations) {
+        const resolvedProperties = properties ?? DEFAULT_DEAL_PROPERTIES;
+        const params = {
+            properties: resolvedProperties,
+        };
+        if (associations)
+            params.associations = associations;
+        return this.request(`/crm/v3/objects/deals/${dealId}`, params);
+    }
+    // ===========================================================================
+    // Companies
+    // ===========================================================================
+    async listCompanies(limit, properties, after) {
+        const resolvedProperties = properties ?? DEFAULT_COMPANY_PROPERTIES;
+        const params = {
+            limit: String(limit ?? 10),
+            properties: resolvedProperties,
+        };
+        if (after)
+            params.after = after;
+        return this.request("/crm/v3/objects/companies", params);
+    }
+    async getCompany(companyId, properties, associations) {
+        const resolvedProperties = properties ?? DEFAULT_COMPANY_PROPERTIES;
+        const params = {
+            properties: resolvedProperties,
+        };
+        if (associations)
+            params.associations = associations;
+        return this.request(`/crm/v3/objects/companies/${companyId}`, params);
+    }
+}
+exports.HubSpotService = HubSpotService;
+//# sourceMappingURL=hubspot.service.js.map

package/build/services/hubspot.service.js.map

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

package/build/tools/company.tools.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { HubSpotService } from "../services/hubspot.service";
+export declare const CompanyToolSchemas: {
+    list_companies: {
+        description: string;
+        schema: z.ZodObject<{
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            properties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            after: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    get_company: {
+        description: string;
+        schema: z.ZodObject<{
+            company_id: z.ZodString;
+            properties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            associations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class CompanyTools {
+    private hubspotService;
+    constructor(hubspotService: HubSpotService);
+    list_companies(args: z.infer<typeof CompanyToolSchemas.list_companies.schema>): Promise<import("../common/types").McpToolResponse>;
+    get_company(args: z.infer<typeof CompanyToolSchemas.get_company.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/company.tools.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompanyTools = exports.CompanyToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.CompanyToolSchemas = {
+    list_companies: {
+        description: "Lists companies from HubSpot CRM with optional property selection and cursor-based pagination. Returns default properties (name, domain, industry, city, state, phone) unless overridden.",
+        schema: zod_1.z.object({
+            limit: zod_1.z.number().optional().default(10).describe("Number of companies to return (max 100)."),
+            properties: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Properties to include (e.g., ['name', 'domain', 'industry']). Uses defaults if not specified."),
+            after: zod_1.z
+                .string()
+                .optional()
+                .describe("Cursor for pagination. Use the value from paging.next.after in previous response."),
+        }),
+    },
+    get_company: {
+        description: "Retrieves full details for a specific HubSpot company including domain, industry, and optional associations (linked contacts, deals).",
+        schema: zod_1.z.object({
+            company_id: zod_1.z.string().describe("The HubSpot company ID (numeric string, e.g., '11111')."),
+            properties: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Properties to include. Uses defaults if not specified."),
+            associations: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Associated object types to include (e.g., ['contacts', 'deals']). Returns linked object IDs."),
+        }),
+    },
+};
+class CompanyTools {
+    hubspotService;
+    constructor(hubspotService) {
+        this.hubspotService = hubspotService;
+    }
+    async list_companies(args) {
+        const companies = await this.hubspotService.listCompanies(args.limit, args.properties, args.after);
+        return (0, utils_1.formatMcpResponse)(companies);
+    }
+    async get_company(args) {
+        const company = await this.hubspotService.getCompany(args.company_id, args.properties, args.associations);
+        return (0, utils_1.formatMcpResponse)(company);
+    }
+}
+exports.CompanyTools = CompanyTools;
+//# sourceMappingURL=company.tools.js.map

package/build/tools/company.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"company.tools.js","sourceRoot":"","sources":["../../src/tools/company.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,kBAAkB,GAAG;IAChC,cAAc,EAAE;QACd,WAAW,EACT,2LAA2L;QAC7L,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YAC7F,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,+FAA+F,CAChG;YACH,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,mFAAmF,CACpF;SACJ,CAAC;KACH;IACD,WAAW,EAAE;QACX,WAAW,EACT,uIAAuI;QACzI,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;YAC1F,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;YACrE,YAAY,EAAE,OAAC;iBACZ,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,8FAA8F,CAC/F;SACJ,CAAC;KACH;CACF,CAAC;AAEF,MAAa,YAAY;IACH;IAApB,YAAoB,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAEtD,KAAK,CAAC,cAAc,CAAC,IAA8D;QACjF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,CACvD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,KAAK,CACX,CAAC;QACF,OAAO,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAA2D;QAC3E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAClD,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,YAAY,CAClB,CAAC;QACF,OAAO,IAAA,yBAAiB,EAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF;AApBD,oCAoBC"}

package/build/tools/contact.tools.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { HubSpotService } from "../services/hubspot.service";
+export declare const ContactToolSchemas: {
+    list_contacts: {
+        description: string;
+        schema: z.ZodObject<{
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            properties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            after: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    get_contact: {
+        description: string;
+        schema: z.ZodObject<{
+            contact_id: z.ZodString;
+            properties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            associations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+    };
+    search_contacts: {
+        description: string;
+        schema: z.ZodObject<{
+            query: z.ZodString;
+            properties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class ContactTools {
+    private hubspotService;
+    constructor(hubspotService: HubSpotService);
+    list_contacts(args: z.infer<typeof ContactToolSchemas.list_contacts.schema>): Promise<import("../common/types").McpToolResponse>;
+    get_contact(args: z.infer<typeof ContactToolSchemas.get_contact.schema>): Promise<import("../common/types").McpToolResponse>;
+    search_contacts(args: z.infer<typeof ContactToolSchemas.search_contacts.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/contact.tools.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContactTools = exports.ContactToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.ContactToolSchemas = {
+    list_contacts: {
+        description: "Lists contacts from HubSpot CRM with optional property selection and cursor-based pagination. Returns default properties (firstname, lastname, email, phone, company) unless overridden.",
+        schema: zod_1.z.object({
+            limit: zod_1.z.number().optional().default(10).describe("Number of contacts to return (max 100)."),
+            properties: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Properties to include (e.g., ['firstname', 'lastname', 'email']). Uses defaults if not specified."),
+            after: zod_1.z
+                .string()
+                .optional()
+                .describe("Cursor for pagination. Use the value from paging.next.after in previous response."),
+        }),
+    },
+    get_contact: {
+        description: "Retrieves full details for a specific HubSpot contact including requested properties and optional associations (linked companies, deals, tickets).",
+        schema: zod_1.z.object({
+            contact_id: zod_1.z.string().describe("The HubSpot contact ID (numeric string, e.g., '12345')."),
+            properties: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Properties to include. Uses defaults if not specified."),
+            associations: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Associated object types to include (e.g., ['companies', 'deals']). Returns linked object IDs."),
+        }),
+    },
+    search_contacts: {
+        description: "Searches HubSpot contacts using free-text search across default searchable properties (name, email, phone, company). Use for finding contacts by name, email, or company.",
+        schema: zod_1.z.object({
+            query: zod_1.z.string().describe("Search query (e.g., 'John', 'john@example.com', 'Acme Corp')."),
+            properties: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Properties to include in results. Uses defaults if not specified."),
+            limit: zod_1.z.number().optional().default(10).describe("Number of results to return (max 100)."),
+        }),
+    },
+};
+class ContactTools {
+    hubspotService;
+    constructor(hubspotService) {
+        this.hubspotService = hubspotService;
+    }
+    async list_contacts(args) {
+        const contacts = await this.hubspotService.listContacts(args.limit, args.properties, args.after);
+        return (0, utils_1.formatMcpResponse)(contacts);
+    }
+    async get_contact(args) {
+        const contact = await this.hubspotService.getContact(args.contact_id, args.properties, args.associations);
+        return (0, utils_1.formatMcpResponse)(contact);
+    }
+    async search_contacts(args) {
+        const contacts = await this.hubspotService.searchContacts(args.query, args.properties, args.limit);
+        return (0, utils_1.formatMcpResponse)(contacts);
+    }
+}
+exports.ContactTools = ContactTools;
+//# sourceMappingURL=contact.tools.js.map

package/build/tools/contact.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.tools.js","sourceRoot":"","sources":["../../src/tools/contact.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,kBAAkB,GAAG;IAChC,aAAa,EAAE;QACb,WAAW,EACT,0LAA0L;QAC5L,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YAC5F,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,mGAAmG,CACpG;YACH,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,mFAAmF,CACpF;SACJ,CAAC;KACH;IACD,WAAW,EAAE;QACX,WAAW,EACT,oJAAoJ;QACtJ,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;YAC1F,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;YACrE,YAAY,EAAE,OAAC;iBACZ,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,+FAA+F,CAChG;SACJ,CAAC;KACH;IACD,eAAe,EAAE;QACf,WAAW,EACT,2KAA2K;QAC7K,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;YAC3F,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,mEAAmE,CAAC;YAChF,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SAC5F,CAAC;KACH;CACF,CAAC;AAEF,MAAa,YAAY;IACH;IAApB,YAAoB,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAEtD,KAAK,CAAC,aAAa,CAAC,IAA6D;QAC/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CACrD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,KAAK,CACX,CAAC;QACF,OAAO,IAAA,yBAAiB,EAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAA2D;QAC3E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAClD,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,YAAY,CAClB,CAAC;QACF,OAAO,IAAA,yBAAiB,EAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAA+D;QACnF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CACvD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,KAAK,CACX,CAAC;QACF,OAAO,IAAA,yBAAiB,EAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF;AA7BD,oCA6BC"}

package/build/tools/deal.tools.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { HubSpotService } from "../services/hubspot.service";
+export declare const DealToolSchemas: {
+    list_deals: {
+        description: string;
+        schema: z.ZodObject<{
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            properties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            after: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    get_deal: {
+        description: string;
+        schema: z.ZodObject<{
+            deal_id: z.ZodString;
+            properties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            associations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class DealTools {
+    private hubspotService;
+    constructor(hubspotService: HubSpotService);
+    list_deals(args: z.infer<typeof DealToolSchemas.list_deals.schema>): Promise<import("../common/types").McpToolResponse>;
+    get_deal(args: z.infer<typeof DealToolSchemas.get_deal.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/deal.tools.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DealTools = exports.DealToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.DealToolSchemas = {
+    list_deals: {
+        description: "Lists deals from HubSpot CRM with optional property selection and cursor-based pagination. Returns default properties (dealname, amount, dealstage, pipeline, closedate) unless overridden.",
+        schema: zod_1.z.object({
+            limit: zod_1.z.number().optional().default(10).describe("Number of deals to return (max 100)."),
+            properties: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Properties to include (e.g., ['dealname', 'amount', 'dealstage']). Uses defaults if not specified."),
+            after: zod_1.z
+                .string()
+                .optional()
+                .describe("Cursor for pagination. Use the value from paging.next.after in previous response."),
+        }),
+    },
+    get_deal: {
+        description: "Retrieves full details for a specific HubSpot deal including pipeline stage, amount, close date, and optional associations (linked contacts, companies).",
+        schema: zod_1.z.object({
+            deal_id: zod_1.z.string().describe("The HubSpot deal ID (numeric string, e.g., '67890')."),
+            properties: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Properties to include. Uses defaults if not specified."),
+            associations: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Associated object types to include (e.g., ['contacts', 'companies']). Returns linked object IDs."),
+        }),
+    },
+};
+class DealTools {
+    hubspotService;
+    constructor(hubspotService) {
+        this.hubspotService = hubspotService;
+    }
+    async list_deals(args) {
+        const deals = await this.hubspotService.listDeals(args.limit, args.properties, args.after);
+        return (0, utils_1.formatMcpResponse)(deals);
+    }
+    async get_deal(args) {
+        const deal = await this.hubspotService.getDeal(args.deal_id, args.properties, args.associations);
+        return (0, utils_1.formatMcpResponse)(deal);
+    }
+}
+exports.DealTools = DealTools;
+//# sourceMappingURL=deal.tools.js.map

package/build/tools/deal.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deal.tools.js","sourceRoot":"","sources":["../../src/tools/deal.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,eAAe,GAAG;IAC7B,UAAU,EAAE;QACV,WAAW,EACT,6LAA6L;QAC/L,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YACzF,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,oGAAoG,CACrG;YACH,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,mFAAmF,CACpF;SACJ,CAAC;KACH;IACD,QAAQ,EAAE;QACR,WAAW,EACT,0JAA0J;QAC5J,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;YACpF,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;YACrE,YAAY,EAAE,OAAC;iBACZ,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,kGAAkG,CACnG;SACJ,CAAC;KACH;CACF,CAAC;AAEF,MAAa,SAAS;IACA;IAApB,YAAoB,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAEtD,KAAK,CAAC,UAAU,CAAC,IAAuD;QACtE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3F,OAAO,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAqD;QAClE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAC5C,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,YAAY,CAClB,CAAC;QACF,OAAO,IAAA,yBAAiB,EAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAhBD,8BAgBC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@vineethnkrishnan/hubspot-mcp",
+  "version": "0.1.1",
+  "description": "A read-only MCP server for HubSpot CRM API, enabling AI assistants to query contacts, deals, and companies.",
+  "main": "build/index.js",
+  "bin": {
+    "hubspot-mcp": "build/index.js"
+  },
+  "files": [
+    "build/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "test": "jest --coverage"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "hubspot",
+    "crm",
+    "ai",
+    "model-context-protocol",
+    "contacts",
+    "deals",
+    "companies"
+  ],
+  "author": "Vineeth Krishnan",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.5.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.7.0"
+  }
+}