Hosted API These pages document MindsHub Cowork, the app and local server you run yourself. For the hosted MindsHub API at api.mindshub.ai, with API keys, see the hosted MindsHub API docs ↗.
Use Cases · Connect

Setup guide for MindsHub Cowork and HubSpot

MindsHub Cowork connects to your HubSpot account so its agent can work with your CRM data. You ask in plain language, and it looks up contacts, companies, and deals in HubSpot to answer.

On this page
  1. What you can do
  2. Install the app
  3. Use the app
  4. Disconnect the app
  5. Uninstall the app

What you can do

Install the app

You need MindsHub Cowork, either the desktop app or the web app (see Setup), and a HubSpot account.

  1. In MindsHub Cowork, open Connect Apps and Data from the sidebar.
  2. Select the HubSpot tile.
  3. Click Authorize with HubSpot. HubSpot's sign-in page opens in your browser.
  4. Sign in to HubSpot and choose the HubSpot account you want to connect.
  5. Review the permissions MindsHub Cowork requests, then click Connect app.
  6. Return to MindsHub Cowork. HubSpot now appears under your connected apps.
The connection can only see what your own HubSpot user can see.

Use the app

Ask in the chat

Start a chat and ask about your HubSpot data. For example:

Run it on a schedule

Ask the agent to run a request regularly, for example "every Monday at 9am, summarize new deals". It then reads fresh data from HubSpot each time the schedule runs.

There is no field mapping or sync to set up. MindsHub Cowork doesn't copy your HubSpot records. It reads them from HubSpot only when a chat or a scheduled task needs them.

Disconnect the app

  1. In MindsHub Cowork, open Connected Apps and Data from the sidebar.
  2. Find your HubSpot connection.
  3. Click Disconnect on it and confirm.
After you disconnect, MindsHub Cowork deletes its stored access to your HubSpot account, and the agent can no longer use your HubSpot data. Nothing is deleted from HubSpot. Answers already given in your chats stay in your conversation history.

Uninstall the app

To also remove the app from your HubSpot account:

  1. In HubSpot, click the settings icon in the top navigation bar.
  2. In the left sidebar, go to Integrations > Connected Apps.
  3. Under My apps, click MindsHub Cowork.
  4. On the app's settings page, uninstall the app and confirm.

See HubSpot's guide to managing connected apps ↗ for more detail.

Uninstalling revokes MindsHub Cowork's access to your HubSpot account. The HubSpot connection in MindsHub Cowork stops working and asks you to reconnect the next time it renews its access. Your HubSpot data isn't affected.