How to Use the HubSpot Service Hub MCP in LlamaIndex

Q: Can I index historical HubSpot Service Hub tickets into a LlamaIndex vector store?

Yes, you can use hssearchtickets to fetch tickets and load them into Document objects. Once loaded, LlamaIndex parses and indexes the ticket subjects and descriptions. This makes your entire support history searchable via semantic queries.

Q: How does LlamaIndex handle pipeline stage IDs from the HubSpot Service Hub MCP Server?

The agent uses hsticketpipelines to fetch your pipeline stages and stores them as metadata. When creating a ticket with hscreateticket, the agent queries this metadata to find the correct stage ID. This ensures the ticket is placed in the right queue.

Q: How do I use HubSpot Service Hub customer ratings to filter LlamaIndex query results?

You fetch customer ratings using hslistfeedback and apply them as metadata tags to your indexed nodes. This allows you to filter your search queries to only retrieve feedback from highly satisfied or highly dissatisfied customers. It helps you analyze specific customer cohorts.

Q: What happens when I update a ticket using this MCP Server?

When you call hsupdateticket, the server updates the specified fields on HubSpot's servers. Your agent should then re-index that specific ticket in LlamaIndex to keep your vector store synchronized with the live CRM data.

Index HubSpot Service Hub tickets and customer feedback directly into your LlamaIndex vector store.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HubSpot Service Hub MCP to LlamaIndex

Create your Vinkius account to connect HubSpot Service Hub to LlamaIndex 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 Service Hub with LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Turn HubSpot Service Hub data into searchable knowledge

The `hs_list_feedback` tool pulls survey names, customer ratings, and response text directly into your LlamaIndex pipeline. Your agent indexes these survey submissions into a vector store to make historical customer feedback semantically searchable. Instead of guessing what customers want, you query the index to find patterns in past complaints. Your RAG pipeline combines this live feedback with internal support wikis to give agents the exact context they need to resolve new cases.

Query live ticket pipelines with LlamaIndex RAG

The `hs_ticket_pipelines` tool retrieves your support stages and internal IDs so your agent always understands your workflow. LlamaIndex indexes these pipeline structures, allowing your agent to map customer queries to the right stage. When a user asks about their case, the agent queries the index to find the correct pipeline stage ID. It then calls `hs_tickets_by_status` to fetch active tickets, ensuring your agent's answers are grounded in your actual CRM structure rather than hallucinations.

Build an MCP Server search index for support tickets

The `hs_search_tickets` tool allows your agent to find active support cases using natural language. LlamaIndex takes the returned ticket properties—including subject, priority, and creation date—and indexes them for instant retrieval. When an agent needs to update a case, they search the index first to see if the ticket exists. If it does, the agent uses `hs_update_ticket` to modify the status, keeping your support database clean and preventing duplicate entries.

Setup guide

Set up HubSpot Service Hub MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all HubSpot Service Hub MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to HubSpot Service Hub tools.",
)
response = await agent.run("List recent HubSpot Service Hub data")

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 Service 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 Service Hub MCP in LlamaIndex

Yes, you can use `hs_search_tickets` to fetch tickets and load them into Document objects. Once loaded, LlamaIndex parses and indexes the ticket subjects and descriptions. This makes your entire support history searchable via semantic queries.

The agent uses `hs_ticket_pipelines` to fetch your pipeline stages and stores them as metadata. When creating a ticket with `hs_create_ticket`, the agent queries this metadata to find the correct stage ID. This ensures the ticket is placed in the right queue.

You fetch customer ratings using `hs_list_feedback` and apply them as metadata tags to your indexed nodes. This allows you to filter your search queries to only retrieve feedback from highly satisfied or highly dissatisfied customers. It helps you analyze specific customer cohorts.

When you call `hs_update_ticket`, the server updates the specified fields on HubSpot's servers. Your agent should then re-index that specific ticket in LlamaIndex to keep your vector store synchronized with the live CRM data.

Yes, all ticket details and pipeline configurations are processed in memory within Vinkius's zero-trust environment. No database logs or CRM data are stored on Vinkius. Connection tokens are handled securely, ensuring your HubSpot API key is never exposed to the LLM client.

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