HubSpot MCP Server

Instructions

🎯 Purpose:
  1. This tool retrieves detailed information about a specific property for a HubSpot object type.
  2. You can use this to get all metadata related to a property, including its type, options,
     and other configuration details.

Implementation Reference

• dist/tools/properties/getPropertyTool.js:35-58 (handler)

  The main handler function that fetches property details from the HubSpot CRM API endpoint /crm/v3/properties/{objectType}/{propertyName} and returns the JSON response or error.

  async process(args) {
      try {
          const response = await this.client.get(`/crm/v3/properties/${args.objectType}/${args.propertyName}`);
          return {
              content: [
                  {
                      type: 'text',
                      text: JSON.stringify(response, null, 2),
                  },
              ],
          };
      }
      catch (error) {
          return {
              content: [
                  {
                      type: 'text',
                      text: `Error retrieving HubSpot property ${args.propertyName} for ${args.objectType}: ${error instanceof Error ? error.message : String(error)}`,
                  },
              ],
              isError: true,
          };
      }
  }

• dist/tools/properties/getPropertyTool.js:6-11 (schema)

  Zod schema defining the input parameters: objectType (string) and propertyName (string) with descriptions.

  const GetPropertySchema = z.object({
      objectType: z
          .string()
          .describe(`The type of HubSpot object the property belongs to. Valid values include: ${HUBSPOT_OBJECT_TYPES.join(', ')}. For custom objects, use the hubspot-get-schemas tool to get the objectType.`),
      propertyName: z.string().describe('The name of the property to retrieve'),
  });

• dist/tools/toolsRegistry.js:37-37 (registration)

  Registers an instance of the GetPropertyTool in the tools registry.

  registerTool(new GetPropertyTool());

• dist/tools/toolsRegistry.js:14-14 (registration)

  Imports the GetPropertyTool class for registration.

  import { GetPropertyTool } from './properties/getPropertyTool.js';

• dist/tools/properties/getPropertyTool.js:12-28 (schema)

  Tool definition object including name, description, input schema (converted to JSON schema), and annotations for MCP compliance.

  const ToolDefinition = {
      name: 'hubspot-get-property',
      description: `
      🎯 Purpose:
        1. This tool retrieves detailed information about a specific property for a HubSpot object type.
        2. You can use this to get all metadata related to a property, including its type, options,
           and other configuration details.
    `,
      inputSchema: zodToJsonSchema(GetPropertySchema),
      annotations: {
          title: 'Get CRM Property Details',
          readOnlyHint: true,
          destructiveHint: false,
          idempotentHint: true,
          openWorldHint: true,
      },
  };