Skip to content

Stacksync × Supabase Miami: AI-Native OperationsOct 13Reserve your spot

Your connection path

HubSpot
Your AI
Stacksync MCP OAuth

Your assistant works through your Stacksync workspace and its available connections.

First request

“Plan a contact and company replica”

Stacksync MCP · CRM

HubSpot MCP integration.

Bring HubSpot connection discovery, connector actions and sync planning into an AI conversation. Use Stacksync MCP to prepare contact and company mappings, review deal automation, or understand why a HubSpot sync has failed records.

Connector actionsSync management
Start using Stacksync MCP Explore example prompts

01 / The connection

What HubSpot can do through MCP

Bring HubSpot connection discovery, connector actions and sync planning into an AI conversation. Use Stacksync MCP to prepare contact and company mappings, review deal automation, or understand why a HubSpot sync has failed records. Choose an AI client below to get started with the Stacksync MCP server.

The server belongs to Stacksync. The available HubSpot operations depend on your connection, permissions, and connector modules.

Explore the HubSpot connector →
ClaudeClaude CodeChatGPTCodexCursorVS CodeWindsurfGemini CLI

02 / Capabilities

HubSpot capabilities through MCP

Choose the connection path that fits the job. Your assistant inspects the available tools before configuring or running an action.

Sync management

Discover HubSpot objects

Inspect the connected account’s available tables and columns before selecting contacts, companies, deals or another supported object.

Connector actions

Prepare CRM actions

Inspect available HubSpot action modules and their input forms before proposing an individual lookup or update.

Sync management

Manage contact and deal syncs

Read existing mappings, select table direction and propose edits without creating a second sync for the same records.

03 / Setup

Set up your AI client

Connect the MCP server first. Then connect HubSpot using the requirements below.

Chat assistantClaude

Connect Claude on the web or desktop to Stacksync through a custom connector and browser sign-in.

Before you start

  • A Stacksync account with access to the workspace you want to use.
  • Permission to add an external MCP server in your AI client.
  • On a Claude Team or Enterprise account, an owner must first add Stacksync under Organization settings → Connectors.

  1. Add a custom connector

    Open Customize → Connectors, select + Add, then Add custom connector. Name it Stacksync and use the server URL below.

    https://mcp.stacksync.com/mcp

  2. Connect your Stacksync account

    Select Connect, complete the Stacksync sign-in in your browser and choose the default workspace. Clear Make changes on the consent screen if you only want read access.

  3. Check your workspace

    Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available HubSpot connection and capabilities.

Full setup documentation ↗
TerminalClaude Code

Add the remote Stacksync server to Claude Code and authenticate from its MCP menu.

Before you start

  • A Stacksync account with access to the workspace you want to use.
  • Permission to add an external MCP server in your AI client.
  • Claude Code installed with the claude command available in your terminal.

  1. Add Stacksync over HTTP

    Run the command below. Add --scope user if you want the connection available across your projects.

    claude mcp add --transport http stacksync https://mcp.stacksync.com/mcp

  2. Finish browser sign-in

    Open Claude Code, run /mcp, select stacksync and complete the Stacksync sign-in. Choose the workspace you want requests to use by default.

  3. Check your workspace

    Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available HubSpot connection and capabilities.

Full setup documentation ↗
Chat assistantChatGPT

Add Stacksync as a custom MCP app in ChatGPT and sign in with OAuth.

Before you start

  • A Stacksync account with access to the workspace you want to use.
  • Permission to add an external MCP server in your AI client.
  • A ChatGPT account with Developer mode and custom MCP apps available. The Stacksync guide lists Plus, Pro, Business, Enterprise and Edu; workspace administrators can restrict access.

  1. Enable custom app setup

    Open Settings → Apps → Advanced settings and turn on Developer mode. If the option is unavailable, check the account or workspace policy with your administrator.

  2. Create the Stacksync app

    Select Create app, name it Stacksync, enter the server URL below and choose OAuth. Complete the Stacksync sign-in and select your default workspace.

    https://mcp.stacksync.com/mcp

  3. Enable Stacksync in your chat

    Select Stacksync from the chat tools menu so the conversation can use its tools. Signing in to ChatGPT itself does not sign you in to Stacksync.

  4. Check your workspace

    Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available HubSpot connection and capabilities.

Full setup documentation ↗
TerminalCodex

Configure Stacksync in Codex with a remote MCP URL and an explicit OAuth login.

Before you start

  • A Stacksync account with access to the workspace you want to use.
  • Permission to add an external MCP server in your AI client.
  • Codex CLI installed with the codex command available.

  1. Register the remote server

    Add the Stacksync endpoint to your Codex MCP configuration.

    codex mcp add stacksync --url https://mcp.stacksync.com/mcp

  2. Sign in with OAuth

    Run the login command and complete the Stacksync browser sign-in. Select a default workspace; restart your Codex session if the tools are not yet listed.

    codex mcp login stacksync

  3. Check your workspace

    Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available HubSpot connection and capabilities.

Full setup documentation ↗
Code editorCursor

Use Stacksync from Cursor by adding a remote server to its MCP configuration.

Before you start

  • A Stacksync account with access to the workspace you want to use.
  • Permission to add an external MCP server in your AI client.
  • Cursor installed with permission to configure MCP servers.

  1. Add the server configuration

    Merge this stacksync entry into the mcpServers object in ~/.cursor/mcp.json. Preserve any servers you already use.

    {
  "mcpServers": {
    "stacksync": {
      "url": "https://mcp.stacksync.com/mcp"
    }
  }
}

  2. Connect from Cursor

    Open Cursor’s MCP settings, select Connect beside stacksync and finish the Stacksync sign-in in your browser.

  3. Check your workspace

    Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available HubSpot connection and capabilities.

Full setup documentation ↗
Code editorVS Code

Connect Stacksync to GitHub Copilot Chat in VS Code using an HTTP MCP server.

Before you start

  • A Stacksync account with access to the workspace you want to use.
  • Permission to add an external MCP server in your AI client.
  • VS Code with Copilot Chat Agent mode available.

  1. Add Stacksync to VS Code

    Run the command below. Alternatively, add a stacksync entry with type http and this URL under servers in your project’s .vscode/mcp.json.

    code --add-mcp '{"name":"stacksync","type":"http","url":"https://mcp.stacksync.com/mcp"}'

  2. Start it in Copilot Chat

    Open Copilot Chat in Agent mode. Start stacksync from the tools picker and complete the Stacksync browser sign-in.

  3. Check your workspace

    Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available HubSpot connection and capabilities.

Full setup documentation ↗
Code editorWindsurf

Add Stacksync to Cascade with Windsurf’s serverUrl configuration and OAuth sign-in.

Before you start

  • A Stacksync account with access to the workspace you want to use.
  • Permission to add an external MCP server in your AI client.
  • Windsurf installed with Cascade and MCP configuration available.

  1. Open the MCP configuration

    In the Cascade panel, open the … menu and select Open MCP config file. Merge this entry into mcp_config.json without removing other servers.

    {
  "mcpServers": {
    "stacksync": {
      "serverUrl": "https://mcp.stacksync.com/mcp"
    }
  }
}

  2. Authorize the first connection

    Save the configuration. Cascade opens the Stacksync sign-in flow the first time it uses the server. Choose your default workspace.

  3. Check your workspace

    Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available HubSpot connection and capabilities.

Full setup documentation ↗
TerminalGemini CLI

Connect the Gemini command-line client to Stacksync through remote HTTP MCP and browser authorization.

Before you start

  • A Stacksync account with access to the workspace you want to use.
  • Permission to add an external MCP server in your AI client.
  • Gemini CLI installed with the gemini command available. These instructions apply to Gemini CLI, not the Gemini web app.

  1. Register Stacksync

    Run the following command in your terminal to add the HTTP server.

    gemini mcp add --transport http stacksync https://mcp.stacksync.com/mcp

  2. Authenticate inside Gemini CLI

    Start Gemini CLI, run the command below and finish the Stacksync sign-in in your browser.

    /mcp auth stacksync

  3. Check your workspace

    Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available HubSpot connection and capabilities.

Full setup documentation ↗

04 / Put it to work

HubSpot workflow prompts

Example prompts for HubSpot. The outcomes describe what to expect, not results from your account. Review the proposed configuration before running it.

01
Sync management

Plan a contact and company replica

Inspect my HubSpot and PostgreSQL connections, available contacts and companies fields, and existing syncs. Propose a one-way reporting replica with stable HubSpot record IDs and the fields needed to join contacts to companies. Separate any association configuration that I must complete in the web app. Wait for my review before creating or starting the sync.

What to expect

A contact and company reporting design with explicit relationship and setup requirements.

02
Connector actions

Design a closed-deal alert

Inspect the HubSpot and Slack connector modules, connections and existing workflows. Propose a workflow that identifies the closed-won deal condition and prepares a message for the Slack channel I choose. Verify the trigger path and every action from the available forms; flag any step that needs the web app. Show the payload and duplicate-message handling before saving or running it.

What to expect

A proposed deal alert with a verified trigger path and channel-specific message payload.

03
Sync management

Review HubSpot field validation failures

Inspect my HubSpot sync issues and current field mappings. Identify failures caused by property formats, permissions or missing required values. Propose a correction for each group with example affected record IDs. Ask me to choose any retry, revert or ignore operation before executing it.

What to expect

An actionable breakdown of HubSpot property errors without silently discarding updates.

05 / Before you run

Requirements and limitations

What you need

  • Connect your AI client to Stacksync MCP, sign in and select the workspace before inspecting its resources.
  • Reuse an authorized app connection or open the secure connection link from Stacksync. Enter credentials in the connection form, never in the chat.
  • Confirm the HubSpot plan and permissions needed for the selected objects; custom objects require HubSpot Enterprise.

What to account for

  • Available actions depend on the live connector catalog, your connected account and MCP Gateway Policies. Inspect the action and its form before using it.
  • The published sync list marks Campaigns as coming soon and Feedback Submissions as unsupported. Other objects may require HubSpot plan entitlements.
  • Association and per-field direction changes use the Stacksync web app. A duplicate custom field named id is excluded where it conflicts with HubSpot’s record ID.

Your workspace. Your permissions.

OAuth access follows your Stacksync role. Choose read-only access during sign-in when appropriate. Workspace owners can enable “Ask before every change”; it is a configurable setting. Direct connector actions also follow gateway policies.

Read about permissions and approvals ↗

If setup does not work

The MCP server does not appear
Check your client’s custom MCP settings and any plan or administrator prerequisites. Reconnect using the setup instructions above.
Your workspace or app is missing
Verify the Stacksync account and workspace selected during OAuth, then inspect the workspace’s connections. Add missing app credentials through the secure connection flow.
An action is unavailable or denied
Inspect the current connector modules and required inputs. Check your workspace role, read-only consent, gateway policy, and the source app’s API permissions.

06 / Common questions

HubSpot MCP questions

Which HubSpot records are supported?

The sync documentation includes contacts, companies, deals, tickets and many other objects. That list describes sync support; the available direct MCP actions must be discovered separately in the connector catalog.

Can I include HubSpot custom objects?

The sync connector documents custom-object support, but the HubSpot account must have the required Enterprise entitlement and the connection must expose the object.

Can the assistant configure HubSpot associations entirely in chat?

It can inspect the sync and prepare the mapping plan. The current sync skill directs association settings and per-field direction to the Stacksync web app.

Reviewed · Product documentation and connector references

Keep building

Connect the rest of your stack.

CRM

Salesforce

Plan a Salesforce reporting replica

ERP

NetSuite

Plan order reporting with line items

Database

PostgreSQL

Prepare a bounded operational query

← All MCP connector guidesCreate your Stacksync account ↗