How to Use the HubSpot Marketing Hub MCP in CrewAI

Q: How do I add the HubSpot Marketing Hub MCP Server to my CrewAI agents?

Install the crewaitools package. For a basic setup, pass the server URL directly into the mcps array in your Agent definition.

Q: Can CrewAI agents share data pulled from HubSpot Marketing Hub?

Yes. CrewAI agents share memory. If Agent A uses hslistcontactlists to find a specific audience size, Agent B can use that exact number in its subsequent tasks.

Q: How do I restrict which HubSpot tools an agent can use?

Use MCPServerHTTP from crewai.mcp and apply a toolfilter. This lets you restrict one agent to hslistcampaigns while giving another agent access to the full suite of MCP tools.

Deploy autonomous marketing teams. Connect CrewAI to HubSpot Marketing Hub and let specialized agents monitor campaigns and lead data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HubSpot Marketing Hub MCP to CrewAI

Create your Vinkius account to connect HubSpot Marketing Hub to CrewAI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HubSpot Marketing Hub with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Assign HubSpot read access to CrewAI agents

You don't need to give every agent in your crew full access to your marketing data. This MCP Server lets you hand specific HubSpot read capabilities to the exact agent that needs them. You can build a researcher agent equipped with `hs_list_campaigns` and `hs_list_landing_pages`. It gathers the active campaign dates and page publish statuses, then passes that context to an analyst agent for review.

Monitor email performance autonomously

Stop manually checking your outbox stats every morning. You can set up a scheduled CrewAI team to audit your email operations without human intervention. A monitoring agent runs `hs_list_marketing_emails` to check the current state of all scheduled sends. If it spots a draft that should be published, it alerts a moderator agent to take action.

Analyze lead quality across forms

Processing form submissions manually wastes hours of your week. A multi-agent setup can pull, read, and categorize incoming leads automatically. One agent uses `hs_list_forms` to identify high-traffic forms and passes the IDs to a data-gatherer agent. That second agent calls `hs_form_submissions` to extract the visitor field values and evaluate lead quality based on your custom criteria.

Setup guide

Set up HubSpot Marketing Hub MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke HubSpot Marketing Hub tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="HubSpot Marketing Hub Analyst",
    goal="Access and analyze HubSpot Marketing Hub data via MCP.",
    backstory="Expert analyst with direct HubSpot Marketing Hub access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent HubSpot Marketing Hub transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="HubSpot Marketing Hub Analyst",
        goal="Access and analyze HubSpot Marketing Hub data via MCP.",
        backstory="Expert analyst with direct HubSpot Marketing Hub access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent HubSpot Marketing Hub transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HubSpot. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HubSpot Marketing Hub now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HubSpot Marketing Hub MCP in CrewAI

Install the crewai[tools] package. For a basic setup, pass the server URL directly into the mcps array in your Agent definition.

Yes. CrewAI agents share memory. If Agent A uses hs_list_contact_lists to find a specific audience size, Agent B can use that exact number in its subsequent tasks.

Use MCPServerHTTP from crewai.mcp and apply a tool_filter. This lets you restrict one agent to hs_list_campaigns while giving another agent access to the full suite of MCP tools.

Yes. A manager agent can delegate HubSpot queries to subordinate agents, asking them to fetch form data or check landing page statuses before making a final decision.

Your agents will read visitor field values, email subject lines, and contact list counts. Vinkius protects this data by running the MCP Server in an ephemeral V8 Isolate, ensuring your HubSpot session remains strictly isolated from other processes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript