HubSpot MCP Server

Instructions

Implementation Reference

• index.ts:1520-1529 (handler)

  MCP tool handler that validates input, calls HubSpotClient.createContact, and returns the JSON response.

  case "hubspot_create_contact": {
    const args = request.params.arguments as unknown as CreateContactArgs;
    if (!args.properties || !args.properties.email) {
      throw new Error("Missing required arguments: properties including email");
    }
    const response = await hubspotClient.createContact(args.properties);
    return {
      content: [{ type: "text", text: JSON.stringify(response) }],
    };
  }

• index.ts:174-203 (schema)

  Tool definition with input schema requiring 'properties' object containing at least 'email', used for validation and documentation.

  const createContactTool: Tool = {
    name: "hubspot_create_contact",
    description: "Create a new contact in HubSpot",
    inputSchema: {
      type: "object",
      properties: {
        properties: {
          type: "object",
          properties: {
            email: {
              type: "string",
              description: "Contact's email address",
            },
            firstname: {
              type: "string",
              description: "Contact's first name",
            },
            lastname: {
              type: "string",
              description: "Contact's last name",
            },
          },
          required: ["email"],
          additionalProperties: true,
          description: "Contact properties",
        },
      },
      required: ["properties"],
    },
  };

• index.ts:603-608 (helper)

  Core helper method in HubSpotClient that wraps the HubSpot API call to crm.contacts.basicApi.create.

  async createContact(properties: { [key: string]: any }): Promise<any> {
    const contactInput = {
      properties,
    };
    return await this.client.crm.contacts.basicApi.create(contactInput);
  }

• index.ts:1707-1725 (registration)

  Registration of the tool in the listTools handler by including createContactTool in the returned tools array.

  tools: [
    searchContactsTool,
    getContactTool,
    createContactTool,
    updateContactTool,
    listDealsTool,
    getDealTool,
    createDealTool,
    updateDealTool,
    listCompaniesTool,
    getCompanyTool,
    getSalesAnalyticsTool,
    getDealHistoryTool,
    getDealNotesTool,
    getEngagementsByDealTool,
    getSalesPerformanceTool,
    getPipelineAnalyticsTool,
    getForecastAnalyticsTool,
  ],

• index.ts:70-77 (schema)

  TypeScript interface defining the expected arguments for the create contact tool.

  interface CreateContactArgs {
    properties: {
      email: string;
      firstname?: string;
      lastname?: string;
      [key: string]: any;
    };
  }