hubspot_create_contact
Create a new contact in HubSpot
LABSCO SUMMARY
Reporting questions get answered in the chat instead of in a CSV export.
The analytics half is what separates this from a record-CRUD wrapper: hubspot_get_pipeline_analytics, hubspot_get_sales_performance, hubspot_get_sales_analytics and hubspot_get_forecast_analytics return stage conversion, per-rep numbers, period aggregates and a forecast as data the model can reason over next to the deals that produced them. The write surface is narrower than the read surface — contacts and deals can be created and updated, while companies are read-only through hubspot_list_companies and hubspot_get_company. Analytics tools take explicit period, pipeline and owner scoping, so the answer is only as good as the scope you pass.
What it is
A HubSpot server that pairs contact, deal and company records with the aggregate sales analytics normally reached through the reporting UI
What you get
- Contact work end to end: query search, read by ID, create and update (hubspot_search_contacts, hubspot_get_contact, hubspot_create_contact, hubspot_update_contact).
- Deal work with paginated listing, read, create and update, plus the property list you want returned (hubspot_list_deals, hubspot_get_deal, hubspot_create_deal, hubspot_update_deal).
- The story around a deal: its complete change history, its notes, and every associated call, email or meeting (hubspot_get_deal_history, hubspot_get_deal_notes, hubspot_get_engagements_by_deal).
- Aggregate sales analytics for a period, scoped by pipeline, stage or deal owner (hubspot_get_sales_analytics).
- Pipeline analytics including conversion rates between stages, rep performance over a period by owner, and a forecast built from the current pipeline and past performance (hubspot_get_pipeline_analytics, hubspot_get_sales_performance, hubspot_get_forecast_analytics).
- Company records read by ID or listed with pagination (hubspot_list_companies, hubspot_get_company).
Requirements
A HubSpot account and HUBSPOT_API_KEY.
Setup effort
One command plus a key — npx -y @scopiousdigital/server-hubspot, then supply credentials
USE CASES
01
Answering how the quarter is tracking without opening a report
Period aggregates, stage conversion and a forecast built from the current pipeline come back as data, so the follow-up question can be asked immediately.
02
Working out where deals are stalling
Stage conversion shows which transition leaks, and a specific deal's change history shows how long it actually sat there and what moved it.
03
Getting the whole story on a deal before the call
The record, the notes on it and every logged call, email and meeting come back separately, which is enough to brief someone who has never seen the account.
04
Logging an inbound lead and the opportunity it opened
Search first so a duplicate contact is not created, then the contact and the deal are filed with the properties you already have in the conversation.
05
Preparing for a one-to-one with a rep's actual numbers
Performance metrics scope to specific owners over a period and pipeline, so the review starts from figures both sides can see.
17 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
hubspot_create_deal
Create a new deal in HubSpot
hubspot_get_company
Get a specific company by ID
hubspot_get_contact
Get a specific contact by ID
hubspot_get_deal
Get a specific deal by ID
hubspot_get_deal_history
Get the complete history of changes to a deal
hubspot_get_deal_notes
Get notes associated with a specific deal
hubspot_get_engagements_by_deal
Get all engagement activities (calls, emails, meetings, etc.) associated with a deal
hubspot_get_forecast_analytics
Get forecasted sales data based on current pipeline and historical performance
hubspot_get_pipeline_analytics
Get analytics for a specific sales pipeline including conversion rates between stages
hubspot_get_sales_analytics
Get aggregated sales analytics data for specific time periods
hubspot_get_sales_performance
Get performance metrics for sales reps over a specific time period
hubspot_list_companies
List companies in HubSpot with pagination
hubspot_list_deals
List deals in HubSpot with pagination
hubspot_search_contacts
Search for contacts in HubSpot using a query string
hubspot_update_contact
Update an existing contact in HubSpot
hubspot_update_deal
Update an existing deal in HubSpot
BEFORE YOU INSTALL
What to know first
Tools you get
17 tools when we connected. The HubSpot Private App needs fourteen scopes: read and write on contacts, deals and companies, plus read on owners, quotes, line items, custom objects and the contact, deal, company and custom schemas. A call can still fail if your HubSpot plan doesn't include that API.
Requires
- npx on PATH
- HUBSPOT_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 17 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @scopiousdigital/server-hubspotMCP Clients
Claude Desktop — npx
CLAUDE DESKTOP — NPX · JSON
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": [
"-y",
"@scopiousdigital/server-hubspot"
],
"env": {
"HUBSPOT_API_KEY": "<YOUR_HUBSPOT_API_KEY>"
}
}
}
}
