KosmoKrator

productivity

HubSpot MCP Gateway for AI Agents

Expose HubSpot tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

HubSpot MCP Gateway

Expose HubSpot to MCP clients with `kosmokrator mcp:serve --integration=hubspot`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server.

Install KosmoKrator 
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
Install gateway entry 
kosmokrator mcp:gateway:install --integration=hubspot --write=deny --json
MCP configuration 
{
  "mcpServers": {
    "kosmokrator-hubspot": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=hubspot",
        "--write=deny"
      ]
    }
  }
}
Serve manually 
kosmokrator mcp:serve --integration=hubspot --write=deny

Client Notes

Use one scoped MCP gateway entry, then adapt the config location to the client or framework.

Claude Code Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry. Claude Code can launch the local kosmo binary directly from the project MCP config.
Cursor Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server. Use the same KosmoKrator install and integration credentials that power terminal and headless runs.
Codex Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy. Keep write access denied or ask-based unless the workspace is trusted.
OpenAI Agents SDK Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway. Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
Claude Agent SDK Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server. Use a narrow integration list so the agent does not load unrelated tools.
Vercel AI SDK Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts. Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.
LangChain Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls. Keep the gateway scoped to the integration and operation class needed by the chain.
LangGraph Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions. Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.
CrewAI Expose KosmoKrator integrations to CrewAI workers as scoped local tools. Use per-worker integration scopes to avoid giving every worker every tool.
Generic MCP Clients Connect any stdio-compatible MCP client to local KosmoKrator integration tools. Start with read-only write policy and expand only for trusted projects.

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names.

MCP toolSource functionType
integration__hubspot__hubspot_create_contact hubspot.hubspot_create_contact Write write
integration__hubspot__hubspot_get_contact hubspot.hubspot_get_contact Read read
integration__hubspot__hubspot_update_contact hubspot.hubspot_update_contact Write write
integration__hubspot__hubspot_search_contacts hubspot.hubspot_search_contacts Read read
integration__hubspot__hubspot_delete_contact hubspot.hubspot_delete_contact Write write
integration__hubspot__hubspot_create_or_update_contact hubspot.hubspot_create_or_update_contact Write write
integration__hubspot__hubspot_list_contacts hubspot.hubspot_list_contacts Read read
integration__hubspot__hubspot_create_company hubspot.hubspot_create_company Write write
integration__hubspot__hubspot_get_company hubspot.hubspot_get_company Read read
integration__hubspot__hubspot_update_company hubspot.hubspot_update_company Write write
integration__hubspot__hubspot_search_companies hubspot.hubspot_search_companies Read read
integration__hubspot__hubspot_list_companies hubspot.hubspot_list_companies Read read
integration__hubspot__hubspot_create_deal hubspot.hubspot_create_deal Write write
integration__hubspot__hubspot_get_deal hubspot.hubspot_get_deal Read read
integration__hubspot__hubspot_update_deal hubspot.hubspot_update_deal Write write
integration__hubspot__hubspot_list_deals hubspot.hubspot_list_deals Read read
integration__hubspot__hubspot_create_ticket hubspot.hubspot_create_ticket Write write
integration__hubspot__hubspot_get_ticket hubspot.hubspot_get_ticket Read read
integration__hubspot__hubspot_update_ticket hubspot.hubspot_update_ticket Write write
integration__hubspot__hubspot_create_association hubspot.hubspot_create_association Write write
integration__hubspot__hubspot_list_associations hubspot.hubspot_list_associations Read read
integration__hubspot__hubspot_list_owners hubspot.hubspot_list_owners Read read
integration__hubspot__hubspot_create_engagement hubspot.hubspot_create_engagement Write write
integration__hubspot__hubspot_list_pipelines hubspot.hubspot_list_pipelines Read read
integration__hubspot__hubspot_list_properties hubspot.hubspot_list_properties Read read
integration__hubspot__hubspot_add_contact_to_list hubspot.hubspot_add_contact_to_list Write write
integration__hubspot__hubspot_list_forms hubspot.hubspot_list_forms Read read
integration__hubspot__hubspot_get_current_user hubspot.hubspot_get_current_user Read read

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.