{"_id":"@cloud9-labs/mcp-hubspot","name":"@cloud9-labs/mcp-hubspot","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@cloud9-labs/mcp-hubspot","version":"0.1.0","description":"MCP server for HubSpot CRM API integration","type":"module","bin":{"mcp-hubspot":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc","dev":"tsc --watch","prepare":"npm run build"},"keywords":["mcp","hubspot","crm","ai","model-context-protocol"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/cloud9-labs/mcp-hubspot.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.26.0","zod":"^3.24.0"},"devDependencies":{"typescript":"^5.7.0"},"engines":{"node":">=20.0.0"},"gitHead":"a22258e082e99a0fd634ed93bb2482339978d66a","types":"./dist/index.d.ts","_id":"@cloud9-labs/mcp-hubspot@0.1.0","bugs":{"url":"https://github.com/cloud9-labs/mcp-hubspot/issues"},"homepage":"https://github.com/cloud9-labs/mcp-hubspot#readme","_nodeVersion":"24.11.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-Xrgp4Hy39H3TMbbcOClBLkAZzMAUnvddj6LxbslhWuPa5OaWzV1LRJ+zwnNYF8HMC0ysUQZMCqWafbZJXGLsyA==","shasum":"278715c9ae909df15d275413e932662f9bc7241e","tarball":"https://registry.npmjs.org/@cloud9-labs/mcp-hubspot/-/mcp-hubspot-0.1.0.tgz","fileCount":24,"unpackedSize":96331,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICCU0kqNWwI5azqsGJWHpCYUSqWEcbISMqchEX1yIgRPAiBgDqDcUVYy1nE91Gr9CiBlEAWLzuE19icikCZ27BFzfg=="}]},"_npmUser":{"name":"cloud9.labs","email":"cloud9.ai.labs@gmail.com"},"directories":{},"maintainers":[{"name":"cloud9.labs","email":"cloud9.ai.labs@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-hubspot_0.1.0_1770847833776_0.1376484704257046"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-11T22:10:33.681Z","0.1.0":"2026-02-11T22:10:33.934Z","modified":"2026-02-11T22:10:34.150Z"},"maintainers":[{"name":"cloud9.labs","email":"cloud9.ai.labs@gmail.com"}],"description":"MCP server for HubSpot CRM API integration","homepage":"https://github.com/cloud9-labs/mcp-hubspot#readme","keywords":["mcp","hubspot","crm","ai","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/cloud9-labs/mcp-hubspot.git"},"bugs":{"url":"https://github.com/cloud9-labs/mcp-hubspot/issues"},"license":"MIT","readme":"# HubSpot CRM MCP Server\n\nA 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.\n\n## Features\n\n- **Contact Management** - Create, read, update, search, and list contacts\n- **Company Management** - Create, read, and search companies\n- **Deal Management** - Create, read, update, and list deals with pipeline tracking\n- **Pipeline Access** - Retrieve deal pipelines and stage configurations\n- **Object Associations** - Link contacts to companies, deals to contacts, etc.\n- **Built-in Rate Limiting** - Automatic throttling (100 req/10s) with 429 retry\n- **Cursor-based Pagination** - Efficient data retrieval for large datasets\n\n## Available Tools (14)\n\n| Tool | Description |\n|------|-------------|\n| `hubspot_create_contact` | Create a new contact |\n| `hubspot_get_contact` | Get contact by ID or email |\n| `hubspot_update_contact` | Update contact properties |\n| `hubspot_search_contacts` | Search contacts with filters |\n| `hubspot_list_contacts` | List contacts with pagination |\n| `hubspot_create_company` | Create a new company |\n| `hubspot_get_company` | Get company by ID |\n| `hubspot_search_companies` | Search companies by name/domain |\n| `hubspot_create_deal` | Create a new deal |\n| `hubspot_get_deal` | Get deal by ID |\n| `hubspot_update_deal` | Update deal properties |\n| `hubspot_list_deals` | List deals with pagination |\n| `hubspot_get_pipelines` | Get all deal pipelines and stages |\n| `hubspot_create_association` | Associate CRM objects together |\n\n## Prerequisites\n\n- Node.js >= 20.0.0\n- HubSpot account with a [Private App access token](https://developers.hubspot.com/docs/api/private-apps)\n\n### Required HubSpot Scopes\n\nYour Private App needs these scopes:\n- `crm.objects.contacts.read` / `crm.objects.contacts.write`\n- `crm.objects.companies.read` / `crm.objects.companies.write`\n- `crm.objects.deals.read` / `crm.objects.deals.write`\n\n## Installation\n\n### Via Smithery\n\n```bash\nnpx -y @smithery/cli install @anthropic/hubspot-mcp --client claude\n```\n\n### Manual Setup\n\n```bash\ngit clone https://github.com/A5O1/new_work.git\ncd new_work/packages/mcp-hubspot\nnpm install\nnpm run build\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"hubspot\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-hubspot/dist/index.js\"],\n      \"env\": {\n        \"HUBSPOT_ACCESS_TOKEN\": \"your-access-token-here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"hubspot\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-hubspot/dist/index.js\"],\n      \"env\": {\n        \"HUBSPOT_ACCESS_TOKEN\": \"your-access-token-here\"\n      }\n    }\n  }\n}\n```\n\n## Usage Examples\n\nOnce connected, you can ask your AI assistant:\n\n- \"Create a contact for John Smith at john@example.com\"\n- \"Search for all contacts at Acme Corp\"\n- \"Create a deal called 'Enterprise License' for $50,000\"\n- \"Show me all deal pipelines and their stages\"\n- \"Associate contact 123 with company 456\"\n- \"List the last 20 deals in our pipeline\"\n\n## Search Filters\n\nThe `hubspot_search_contacts` tool supports advanced filtering:\n\n```\nOperators: EQ, NEQ, LT, LTE, GT, GTE, BETWEEN, IN, NOT_IN,\n           HAS_PROPERTY, NOT_HAS_PROPERTY, CONTAINS_TOKEN, NOT_CONTAINS_TOKEN\n```\n\nExample: Search contacts where lifecycle stage equals \"lead\":\n```json\n{\n  \"query\": \"\",\n  \"filters\": [\n    {\n      \"propertyName\": \"lifecyclestage\",\n      \"operator\": \"EQ\",\n      \"value\": \"lead\"\n    }\n  ]\n}\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-7fa5e12eabcf72cafc10ceedfc1c3ac3"}