H

Harvey

Always Be Closing
Checking…

Today

Anything waiting on you, then everything Harvey has built so far.

Recent activity

Signals

Harvey proposes what it knows how to look for. You decide what actually defines a good prospect — nothing is collected until you confirm it.

Cohort builder

A prospect list is a query, not a file. Pick the signals a good prospect must have — and any that disqualify them — and see how many companies match right now.

Discover

Find businesses matching your ICP. Pick a source, see what it will cost, then run it — nothing is called until you press the button.

Run

Companies

Organizations Harvey has researched. Click a row to see its contacts.

Contacts

People Harvey has found and verified.

Export deliverable CSV Export all

Campaigns

Email sequences Harvey has written and deployed.

Outbox

Every outgoing email stops here. Read one, decide, move on — A approve, R reject, J/K to move.

Conversations

Every reply, and how Harvey handled it.

Activity

A running log of every action Harvey's agents have taken.

Usage

Actual Claude usage — your subscription quota, calls, and tokens per agent and task. Subscription plans aren't billed per token, so no dollar costs here.

Settings

Credentials are stored locally in .env — never sent anywhere except the services themselves.

Email Provider

How Harvey sends and reads replies. Active provider: … — change it by setting channels.email.provider in harvey.yaml to gmail, smtp, or instantly.

Gmail / Google Workspace recommended

Use a mailbox on a dedicated secondary domain. Create an OAuth client (type "Desktop app") in Google Cloud Console → Gmail API, paste the id/secret, save, then run harvey gmail auth in your terminal.

SMTP + IMAP mailbox

Any real mailbox (AgentMail, Fastmail, a Workspace app password). IMAP defaults to the SMTP host/login if left blank.

Instantly legacy

Get your API key from Instantly Settings → Integrations (Growth plan+ for API).

Email Verification strongly recommended

Add at least one so found emails get verified. Without any, addresses stay and are never sent. Reoon has the best free tier (600/mo).

LinkedIn optional

For automated LinkedIn prospecting. Harvey logs in and searches like a human.

Cloudflare optional

For deep website crawling with JavaScript rendering during product training. ~$5/month.

Controls

Start and stop Harvey's heartbeat loop, and watch what it's doing.

Agent

Stopped

Recent Logs

No logs yet. Start Harvey to see activity.

Help

What Harvey is, how it works, and how to fix the usual problems.

What is Harvey?

Harvey is an autonomous AI sales agent. Once set up, Harvey runs on its own: finds people who match your ideal customer, writes personalized cold emails, sends them through your email platform, reads every reply, handles objections, and works toward booking a meeting. You review everything through this dashboard.

Harvey runs on your Claude Max subscription, so there are no extra AI costs. Everything stays on your machine in one folder.

Getting Started

There are three things to do:

1. Go to the Settings tab and enter your Instantly API key
2. Train Harvey on your product (through Claude or the command line)
3. Go to the Controls tab and click Start

The Setup tab shows you exactly what's done and what still needs to happen.

Where Everything Lives

Everything Harvey needs is inside this one project folder. Nothing is stored elsewhere.

.envYour API keys and credentials (never shared or committed)
harvey.yamlYour product info, target customers, and behavior settings
skills/Sales knowledge files. Edit these to change how Harvey writes and sells.
skills/product_knowledge.mdEverything Harvey knows about your product (auto-generated from training)
prompts/Prompt templates for each agent. Advanced customization.
data/harvey.dbDatabase with all prospects, campaigns, and conversations
data/harvey.logLog file showing what Harvey is doing

Getting Your API Keys

Instantly API Key (required)

Instantly is the email platform Harvey uses to send campaigns.

1. Sign up at instantly.ai (you need the Growth plan for API access)

2. Go to Settings > Integrations

3. Copy your API key

4. Paste it in the Settings tab here

LinkedIn Credentials (optional)

If you want Harvey to find prospects on LinkedIn, enter your LinkedIn email and password. Harvey uses a real browser to search LinkedIn like a human would, with random delays and rate limits to avoid detection.

If you skip this, Harvey will find prospects through Google searches and company website scraping instead.

Cloudflare Browser Rendering (optional)

This is only used during product training (when Harvey crawls your website to learn about your product). It handles JavaScript-heavy websites that a basic crawler can't read.

1. Sign up at Cloudflare (paid Workers plan, ~$5/month)

2. Go to Workers & Pages > Browser Rendering

3. Create an API token with Browser Rendering Edit permissions

4. Enter your Account ID and API Token in the Settings tab

Without this, Harvey uses a built-in crawler that works fine for most websites but can't render JavaScript.

Common Issues

"command not found: harvey"
You need to activate the virtual environment first: source .venv/bin/activate
Instantly API returns 401
Your API key is wrong, or you need the Growth plan (the free plan doesn't include API access). Double-check the key in Settings > Integrations in your Instantly dashboard.
Claude headless mode fails
Make sure you've run claude login in your terminal and have an active Claude Max subscription. Harvey uses your existing subscription, not a separate API key.
Harvey isn't finding prospects
Check that your ICP (ideal customer profile) in harvey.yaml has realistic titles, industries, and geography. If LinkedIn is set up, check that the credentials are correct. Check the Activity tab to see what Harvey has been trying to do.