How to Import Your HubSpot Data into DenchClaw

How to import HubSpot contacts, companies, and deals into DenchClaw step by step. No API key required — the browser agent handles the export automatically.

Mark Rachapoom

March 14, 2026·5 min read

Importing from HubSpot into DenchClaw takes about 20–45 minutes depending on how much data you have. You don't need an API key. You don't need HubSpot admin access beyond what you already have. DenchClaw's browser agent logs into HubSpot as you — using your existing Chrome session — and handles the export automatically.

Here's exactly how to do it.

Before You Start#

Make sure you have:

DenchClaw installed (npx denchclaw — takes about 2 minutes)
Chrome open and logged into HubSpot
Enough disk space (most HubSpot exports are under 100MB)

If you haven't set up DenchClaw yet, follow the full setup guide first. It's a single command.

Step 1: Tell DenchClaw to Import HubSpot#

Open DenchClaw web chat at localhost:3100 and type:

Import my HubSpot contacts and companies into DenchClaw

DenchClaw will ask you to confirm, then launch the browser agent. You'll see a Chrome window open (or a new tab in your existing Chrome), navigate to HubSpot, and begin the export process.

Step 2: What the Browser Agent Does#

The browser automation process works like this:

Navigates to your HubSpot account using your existing logged-in session — no login required
Goes to Contacts → Export and triggers a full contacts export
Waits for the export email to arrive in your Gmail (also accessed via your browser session)
Downloads the CSV from the email link
Repeats the same process for Companies and then for Deals if you want them

This usually takes 5–15 minutes depending on how large your HubSpot database is.

Step 3: Field Mapping#

Once the CSV files are downloaded, DenchClaw shows you a field mapping interface. This is where you tell it how your HubSpot fields correspond to DenchClaw's schema.

The most common mappings are automatic:

First Name + Last Name → Full Name
Email → Email
Company Name → Company (relation field)
Phone Number → Phone
Lifecycle Stage → Status
Deal Stage → pipeline stage
Close Date → Close Date

For custom HubSpot properties, you'll see a list of unmapped fields and can either create new DenchClaw fields for them or skip them.

Step 4: Review and Confirm#

Before the import runs, DenchClaw shows you a preview:

Number of contacts to import
Number of companies
Number of deals
Any duplicate detection warnings (if you already have some of these in DenchClaw)
Fields that will be created

Confirm the import, and DenchClaw writes everything to your local DuckDB database.

Step 5: Verify the Import#

After the import completes, switch to the People view in DenchClaw and verify the data looks right. Run a quick query:

Show me the 10 most recently imported contacts

Or check your total contact count against what HubSpot shows.

Handling Large HubSpot Databases#

If you have more than 10,000 contacts, the export process takes longer but works the same way. HubSpot batches large exports, so you might get multiple CSV files. DenchClaw handles multi-file imports automatically.

For databases over 50,000 contacts, you may want to import in segments:

Start with your most important contacts (highest engagement scores or most recent activity)
Import deals and companies first to establish the relational structure
Import contacts in batches, mapped to their companies

What Doesn't Import Automatically#

A few things require manual work:

Email history: HubSpot email logs aren't easily exportable. You'll have activity summaries but not full email threads.
HubSpot-specific automation workflows: Your Workflows stay in HubSpot — they don't translate to DenchClaw directly (though DenchClaw has its own automation via Action Fields and the browser agent).
Attached files and documents: File attachments linked to contact records require manual download.

Keeping HubSpot in Sync During Transition#

If you're transitioning gradually (running both systems for a period), DenchClaw can periodically re-import new HubSpot contacts. Just run the import command again — DenchClaw's duplicate detection prevents double-importing existing records.

What DenchClaw Offers That HubSpot Doesn't#

Once your data is in DenchClaw, you immediately get capabilities HubSpot doesn't have:

Sub-millisecond queries against your full contact database (DuckDB vs. HubSpot's cloud API latency)
Natural language operations — "find all contacts at companies with over 100 employees who haven't been contacted in 60 days" executes instantly
Full data ownership — your contacts are in a local DuckDB file you control
No per-contact limits — HubSpot Free caps at 1M marketing contacts; DenchClaw has no such limits

The import is reversible, too. If you want to go back to HubSpot, you can export from DenchClaw as CSV and re-import.