A
licenseA
qualityD
maintenanceA read-only MCP server that exposes HubSpot CRM data (contacts, deals, companies, quotes) to AI agents, enabling natural language queries.
9
MIT
luigi-ucp-server
Integrates with HubSpot CRM to manage buyer profiles (contacts), product catalogs, carts, and orders (deals) through Universal Commerce Protocol primitives.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@luigi-ucp-serverShow me the pizza menu"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Luigi's Pizzeria — UCP Server
A local MCP server implementing Universal Commerce Protocol (UCP) primitives, backed by HubSpot CRM. Built as a proof-of-concept for the AgentFriend blog.
Architecture
[Buyer Agent: Claude] ←→ MCP (stdio) ←→ [This Server] ←→ HubSpot CRMRelated MCP server: hubspot-mcp-server
UCP Primitive Mapping
UCP Primitive | MCP Tool | Backend |
|
| HubSpot Contacts |
|
| HubSpot Products |
|
| in-memory |
|
| HubSpot Deals |
Setup
pip install -r requirements.txt
cp .env.example .env
# Add your HubSpot Private App token to .envRegister as MCP server in Claude Code
Add to your ~/.claude/settings.json:
{
"mcpServers": {
"luigi-ucp-server": {
"command": "python",
"args": ["/absolute/path/to/luigi-ucp-server/server.py"],
"env": {
"HUBSPOT_ACCESS_TOKEN": "your-token-here"
}
}
}
}HubSpot Private App Setup
HubSpot → Settings → Integrations → Private Apps
Create a Private App with these scopes:
crm.objects.contacts.readcrm.objects.products.readcrm.objects.deals.writecrm.objects.line_items.write(Notes are readable via
crm.objects.contacts.read— no separate scope needed)
Copy the token into
.env
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues
Related MCP Connectors
MCP server for the HubSpot Integrations Center HubDB: search and retrieve integration data.
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables interaction with HubSpot CRM through MCP, providing tools to manage contacts, companies, deals, and search/associations via natural language.18947 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the HubSpot CRM API with tools for managing contacts, companies, deals, tickets, and CRM workflows. Generated with MCPForge. Sensitive operations can be protected with permissions, audit logs, and approval workflows.5 npmMIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that provides AI assistants with full access to HubSpot CRM. Manage contacts, companies, deals, pipelines, and associations directly from Claude, Cursor, or any MCP-compatible client.1 npmMIT