{"type":"mcp_server","name":"mcp-hubspot","description":"This repository provides a Model Context Protocol (MCP) server for integrating AI models with HubSpot CRM, enabling interaction with HubSpot data through tools like contact management. It allows AI to","category":"Sales","language":"Python","stars":127,"forks":13,"owner":"baryhuang","github_url":"https://github.com/baryhuang/mcp-hubspot","homepage":null,"setup":"## Setup\n\n### Installing via Smithery\n\nTo install buryhuang/mcp-hubspot for Claude Desktop automatically via [Smithery](https://smithery.ai/server/buryhuang/mcp-hubspot):\n\n```bash\nnpx -y @smithery/cli install buryhuang/mcp-hubspot --client claude\n```\n\n### Prerequisites\n\nYou'll need a HubSpot access token. You can obtain this by:\n1. Creating a private app in your HubSpot account:\n   Follow the [HubSpot Private Apps Guide](https://developers.hubspot.com/docs/guides/apps/private-apps/overview)\n   - Go to your HubSpot account settings\n   - Navigate to Integrations > Private Apps\n   - Click \"Create private app\"\n   - Fill in the basic information:\n     - Name your app\n     - Add description\n     - Upload logo (optional)\n   - Define required scopes:\n     - tickets\n     - crm.objects.contacts.write\n     - crm.objects.contacts.sensitive.read\n     - crm.objects.companies.sensitive.read\n     - sales-email-read\n     - crm.objects.deals.sensitive.read\n     - crm.objects.companies.write\n     - crm.objects.companies.read\n     - crm.objects.deals.read\n     - crm.objects.deals.write\n     - crm.objects.contacts.read\n   - Review and create the app\n   - Copy the generated access token\n\nNote: Keep your access token secure and never commit it to version control.\n\n### Docker Installation\n\nYou can either build the image locally or pull it from Docker Hub. The image is built for the Linux platform.\n\n#### Supported Platforms\n- Linux/amd64\n- Linux/arm64\n- Linux/arm/v7\n\n#### Option 1: Pull from Docker Hub\n```bash\ndocker pull buryhuang/mcp-hubspot:latest\n```\n\n#### Option 2: Build Locally\n```bash\ndocker build -t mcp-hubspot .\n```\n\nRun the container:\n```bash\ndocker run \\\n  -e HUBSPOT_ACCESS_TOKEN=your_access_token_here \\\n  buryhuang/mcp-hubspot:latest\n```\n\nYou can also pass the access token directly as a command-line argument:\n\n```bash\ndocker run \\\n  buryhuang/mcp-hubspot:latest \\\n  --access-token your_access_token_here\n```\n\n## Cross-Platform Publishing\n\nTo publish the Docker image for multiple platforms, you can use the `docker buildx` command. Follow these steps:\n\n1. **Create a new builder instance** (if you haven't already):\n   ```bash\n   docker buildx create --use\n   ```\n\n2. **Build and push the image for multiple platforms**:\n   ```bash\n   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push .\n   ```\n\n3. **Verify the image is available for the specified platforms**:\n   ```bash\n   docker buildx imagetools inspect buryhuang/mcp-hubspot:latest\n   ```\n\n\n## Usage with Claude Desktop\n\n### Installing via Smithery\n\nTo install mcp-hubspot for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-hubspot/prod):\n\n```bash\nnpx -y @smithery/cli@latest install mcp-hubspot --client claude\n```\n\n### Docker Usage\n```json\n{\n  \"mcpServers\": {\n    \"hubspot\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-e\",\n        \"HUBSPOT_ACCESS_TOKEN=your_access_token_here\",\n        \"buryhuang/mcp-hubspot:latest\"\n      ]\n    }\n  }\n}\n```\n\nYou can also use the command-line argument:\n\n```json\n{\n  \"mcpServers\": {\n    \"hubspot\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"buryhuang/mcp-hubspot:latest\",\n        \"--access-token\",\n        \"your_access_token_here\"\n      ]\n    }\n  }\n}\n```\n\n## Development\n\nTo set up the development environment:\n\n```bash\npip install -e .\n```","tools":"## Available Tools\n\n\t\t1. `hubspot_create_contact` (Create a new contact in HubSpot, checking for duplicates.)\n\t\t2. `hubspot_create_company` (Create a new company in HubSpot, checking for duplicates.)\n\t\t3. `hubspot_get_company_activity` (Get activity history for a specific company.)\n\t\t4. `hubspot_get_recent_engagements` (Get recent engagement activities across all contacts and companies.)\n\t\t5. `hubspot_get_recent_companies` (Get most recently active companies from HubSpot.)\n\t\t6. `hubspot_get_recent_contacts` (Get most recently active contacts from HubSpot.)","faq":null,"created_at":"2024-12-27T08:40:49+00:00","updated_at":"2025-03-28T05:50:30+00:00","source_url":"https://model-context-protocol.com/servers/mcp-hubspot-ai-model-integration-crm","related_articles":[]}