KosmoKrator

productivity

HubSpot MCP Integration for OpenAI Agents SDK

Connect HubSpot to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

25 functions 12 read 13 write Bearer token auth
Submit HubSpot feedback View package source

Connect HubSpot to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

HubSpot MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-hubspot": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=hubspot",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=hubspot --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only HubSpot instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

HubSpot Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the HubSpot integration catalog.

MCP toolSource functionTypeDescription
integration__hubspot__hubspot_create_contact hubspot.hubspot_create_contact Write Create a new contact in HubSpot CRM. Supports firstname, lastname, email, phone, company, and any additional custom properties. Returns the created contact with its HubSpot ID and properties.
integration__hubspot__hubspot_get_contact hubspot.hubspot_get_contact Read Retrieve a HubSpot contact by its ID. Returns the contact's ID, properties, and associated data. Optionally specify which properties to include.
integration__hubspot__hubspot_update_contact hubspot.hubspot_update_contact Write Update an existing HubSpot contact by ID. Provide a properties object with the fields to update (e.g., {"firstname": "Jane", "phone": "555-0100"}). Returns the updated contact.
integration__hubspot__hubspot_search_contacts hubspot.hubspot_search_contacts Read Search HubSpot contacts using filter groups and/or a text query. Use filterGroups for structured queries (e.g., email equals "[email protected]"). Use query for full-text search across searchable properties. Supports pagination with limit and after parameters.
integration__hubspot__hubspot_delete_contact hubspot.hubspot_delete_contact Write Delete a HubSpot contact by ID. Permanently removes the contact from HubSpot CRM. This action cannot be undone.
integration__hubspot__hubspot_create_or_update_contact hubspot.hubspot_create_or_update_contact Write Create or update a HubSpot contact by email. First searches for an existing contact matching the email. If found, updates it. If not found, creates a new contact. Supports firstname, lastname, phone, company, and any additional custom properties.
integration__hubspot__hubspot_create_company hubspot.hubspot_create_company Write Create a new company in HubSpot CRM. Supports name, domain, and any additional custom properties. Returns the created company with its HubSpot ID and properties.
integration__hubspot__hubspot_get_company hubspot.hubspot_get_company Read Retrieve a HubSpot company by its ID. Returns the company's ID, properties, and associated data. Optionally specify which properties to include.
integration__hubspot__hubspot_update_company hubspot.hubspot_update_company Write Update an existing HubSpot company by ID. Provide a properties object with the fields to update (e.g., {"name": "Acme Corp", "domain": "acme.com"}). Returns the updated company.
integration__hubspot__hubspot_search_companies hubspot.hubspot_search_companies Read Search HubSpot companies using filter groups and/or a text query. Use filterGroups for structured queries (e.g., domain equals "acme.com"). Use query for full-text search across searchable properties. Supports pagination with limit and after parameters.
integration__hubspot__hubspot_create_deal hubspot.hubspot_create_deal Write Create a new deal in HubSpot CRM. Supports dealname, amount, pipeline, dealstage, closedate, and any additional custom properties. Returns the created deal with its HubSpot ID and properties.
integration__hubspot__hubspot_get_deal hubspot.hubspot_get_deal Read Retrieve a HubSpot deal by its ID. Returns the deal's ID, properties, and associated data. Optionally specify which properties to include.
integration__hubspot__hubspot_update_deal hubspot.hubspot_update_deal Write Update an existing HubSpot deal by ID. Provide a properties object with the fields to update (e.g., {"dealstage": "closedwon", "amount": "5000"}). Returns the updated deal.
integration__hubspot__hubspot_list_deals hubspot.hubspot_list_deals Read List deals in HubSpot CRM with cursor-based pagination. Optionally specify properties to include and control page size. Use the "after" cursor from a previous response to fetch the next page.
integration__hubspot__hubspot_create_ticket hubspot.hubspot_create_ticket Write Create a new ticket in HubSpot CRM. Supports subject, content, hs_pipeline, hs_pipeline_stage, and any additional custom properties. Returns the created ticket with its HubSpot ID and properties.
integration__hubspot__hubspot_get_ticket hubspot.hubspot_get_ticket Read Retrieve a HubSpot ticket by its ID. Returns the ticket's ID, properties, and associated data. Optionally specify which properties to include.
integration__hubspot__hubspot_update_ticket hubspot.hubspot_update_ticket Write Update an existing HubSpot ticket by ID. Provide a properties object with the fields to update (e.g., {"subject": "New subject", "hs_pipeline_stage": "2"}). Returns the updated ticket.
integration__hubspot__hubspot_create_association hubspot.hubspot_create_association Write Create an association between two HubSpot CRM objects. For example, associate a contact to a company, or a deal to a company. Specify the from/to object types (contacts, companies, deals, tickets), their IDs, and the association type. Common association types: contact_to_company, company_to_contact, deal_to_company, ticket_to_contact.
integration__hubspot__hubspot_list_associations hubspot.hubspot_list_associations Read List associations from a HubSpot CRM object to another object type. For example, list all companies associated with a specific contact. Returns the associated object IDs and association types.
integration__hubspot__hubspot_list_owners hubspot.hubspot_list_owners Read List HubSpot CRM owners (users). Returns owner IDs, names, and emails. Useful for assigning owners to contacts, deals, and tickets. Supports pagination with limit and after parameters.
integration__hubspot__hubspot_create_engagement hubspot.hubspot_create_engagement Write Create an engagement in HubSpot CRM (note, task, or meeting). Specify the type and provide the relevant properties. For notes: body (HTML content). For tasks: hs_task_body, hs_task_subject, hs_task_status. For meetings: hs_meeting_title, hs_meeting_body, hs_meeting_start_time, hs_meeting_end_time.
integration__hubspot__hubspot_list_pipelines hubspot.hubspot_list_pipelines Read List HubSpot CRM pipelines for a given object type. Returns all pipelines and their stages. Commonly used for deals and tickets. Use the object type "deals" or "tickets" to get the respective pipelines.
integration__hubspot__hubspot_list_properties hubspot.hubspot_list_properties Read List HubSpot CRM property definitions for a given object type. Returns all properties including their name, label, type, and field type. Useful for discovering available properties for contacts, companies, deals, or tickets.
integration__hubspot__hubspot_add_contact_to_list hubspot.hubspot_add_contact_to_list Write Add contacts to a HubSpot marketing list. Provide either contact_ids (HubSpot vid IDs) or emails (email addresses), or both. Contacts that are already in the list are silently skipped.
integration__hubspot__hubspot_list_forms hubspot.hubspot_list_forms Read List HubSpot marketing forms. Returns form IDs, names, types, and creation timestamps. Supports pagination with limit and after parameters.

Related HubSpot Pages

HubSpot CLIUse direct JSON commands instead of MCP discovery. HubSpot MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.