Can I use HubSpot as a CLI?

Yes. KosmoKrator exposes a HubSpot CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose HubSpot through MCP?

Yes. The KosmoKrator MCP gateway can expose selected HubSpot tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are HubSpot credentials stored?

HubSpot credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for HubSpot MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

marketing

HubSpot MCP, CLI, and Lua Integration for AI Agents

HubSpot integration docs for AI agents: MCP gateway setup, HubSpot CLI commands, Lua API reference, credentials, and function schemas.

7 functions 6 read 1 write Manual OAuth token auth

Submit HubSpot feedback View package source

HubSpot for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: hubspot3
route_slug: hubspot3
package: hubspot3
auth_strategy: oauth2_manual_token Manual OAuth token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. HubSpot CLIHeadless setup and direct function calls. HubSpot MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

HubSpot MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for HubSpot.

Claude Code HubSpot MCP setup for Claude Code. Cursor HubSpot MCP setup for Cursor. Codex HubSpot MCP setup for Codex. OpenAI Agents HubSpot MCP setup for OpenAI Agents SDK. Claude Agent SDK HubSpot MCP setup for Claude Agent SDK. Vercel AI SDK HubSpot MCP setup for Vercel AI SDK. LangChain HubSpot MCP setup for LangChain. LangGraph HubSpot MCP setup for LangGraph. CrewAI HubSpot MCP setup for CrewAI. MCP clients HubSpot MCP setup for Generic MCP Clients.

HubSpot CLI Matrix

Use these pages for direct HubSpot CLI workflows in scripts, CI, cron, and agent wrappers.

CI HubSpot CLI for CI. Cron Jobs HubSpot CLI for cron jobs. Shell Scripts HubSpot CLI for shell scripts. Headless Automation HubSpot CLI for headless automation. Coding Agents HubSpot CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`hubspot3.hubspot3_list_contacts`	Read `read`	3	List HubSpot contacts. Returns contact IDs, emails, names, and associated company IDs. Use limit and offset for pagination, and properties to select specific fields.
`hubspot3.hubspot3_get_contact`	Read `read`	1	Retrieve a HubSpot contact by its ID (vid). Returns the full contact profile including all properties, form submissions, and lists.
`hubspot3.hubspot3_create_contact`	Write `write`	6	Create a new HubSpot contact. Requires an email address. Optionally set first name, last name, phone, company, and other properties. Returns the created contact with its ID.
`hubspot3.hubspot3_list_companies`	Read `read`	3	List HubSpot companies. Returns company IDs, names, domains, and other properties. Use limit and offset for pagination.
`hubspot3.hubspot3_get_company`	Read `read`	1	Retrieve a HubSpot company by its ID. Returns the full company profile including name, domain, industry, and other properties.
`hubspot3.hubspot3_list_deals`	Read `read`	3	List HubSpot deals. Returns deal IDs, names, stages, amounts, and associated contacts/companies. Use limit and offset for pagination.
`hubspot3.hubspot3_get_current_user`	Read `read`	0	Retrieve the currently authenticated HubSpot user's information. Returns the user's ID, email, name, and portal information. Useful for identifying which account or token is in use.