<- all tokdocs

Harvey Cold Email Agent for Claude Code: Setup, Costs and Limits

By , founder of Mavric and Apso

View on TikTok ->

Harvey is an open-source agent at github.com/ethanplusai/harvey that finds prospects, profiles their websites, writes cold emails and works replies toward a meeting, using your Claude Pro or Max login. A TikTok from @jackroberts____ calls it free and hands-off. The code is free under the MIT license, but sending needs a dedicated mailbox, a warmup service and your approval on every email by default, and Anthropic's terms describe subscription limits in terms of "ordinary, individual usage".

What is Harvey?

The Harvey README describes a set of agents driven by editable Markdown skill files:

  • a writer that drafts each email around specifics of the prospect
  • a sender
  • a reply handler that works conversations toward a meeting
  • an analyst

Before writing, Harvey discovers prospects from several providers, profiles their websites for facts such as ad pixels, incumbent agencies and open roles, identifies owners and verifies email addresses. When I fetched the page it showed 3.1k stars, 631 forks, 376 commits and release 0.2.1. The owner appears only as the account "ethanplusai".

Harvey is also the name of an unrelated legal AI company. Nothing in the README connects the two.

Is Harvey free?

The code is free. Running it is not. The README lists:

  • Python 3.11 or later
  • a mailbox to send from (Gmail or Workspace, or Microsoft 365), ideally on a dedicated secondary domain
  • a mailbox warmup service, with TrulyInbox recommended through affiliate links
  • a Claude Pro or Max subscription with the Claude CLI logged in

The default prospect source, OpenStreetMap, is free. Optional discovery sources such as DataForSEO, Serper and Scavio need their own accounts, and Harvey shows cost estimates before any paid call. Expect to pay for a domain, a mailbox, warmup and possibly lead data.

How to set up Harvey

The video says "Just tell it what you sell and who your ideal customer is." The README's setup has more steps:

  1. Configure .env and harvey.yaml.
  2. Run harvey train against your own website.
  3. Confirm the "signals" that define a good prospect.
  4. Discover prospects.
  5. Start harvey dashboard and harvey run.

The README also offers a path where Claude Code runs a setup wizard inside the repo. The video shows an animated terminal line, "harvey train bookwell.te", which matches the command name but is not output from a real run.

Does Harvey send emails and book calls on its own?

Not by default. The video says Harvey "reads the replies and pushes those people towards a booked call for you." The README puts every outgoing email in an approval queue until you approve it. Autopilot is optional, and even then some emails are held for review.

The README also sets compliance and deliverability requirements:

  • an opt-out line and a postal address in each cold email, set in config before the first campaign
  • a do_not_contact list and an optional Precleared check for GDPR and PECR style rules, with a note that this is not legal advice
  • LinkedIn automation off by default, because it violates LinkedIn's terms
  • a dedicated domain with SPF, DKIM and DMARC, and a warmup of 2 to 4 weeks

A fresh domain cannot send at volume for weeks. Neither the video nor the README reports a reply rate, conversion rate or booked-call count.

Can Harvey run on your Claude plan?

The README says model calls run through your logged-in Claude CLI, with no API keys or per-token billing. It lists Codex on a ChatGPT plan as an opt-in alternative on macOS and Linux only, which the video does not mention.

Anthropic's Claude Code legal and compliance page adds conditions:

  • OAuth login is intended for subscription purchasers and designed for ordinary use of Claude Code and other native Anthropic apps.
  • Developers building products or services on the Agent SDK should use API key authentication.
  • Advertised Pro and Max limits assume "ordinary, individual usage" of Claude Code and the Agent SDK.
  • Anthropic may enforce these restrictions without prior notice.
  • An end user may sign in to the unmodified Claude Code binary with their own subscription.

A personal tool that drives your own CLI sits closer to the permitted case than a service that routes other people's requests through your login. An unattended loop sending hundreds of emails is still a heavier load than the page describes, and Anthropic does not classify this exact pattern. Expect to hit usage limits on large campaigns, and read the current terms first.

Harvey vs. a lead-gen agency

The video shows a mock agency invoice with line items for "Lead research", "List building", "Outreach" and "Account manager", and a "Cancel retainer" button. The amounts are blurred, so no price comparison is made. Harvey covers the research and outreach labor. You still carry the deliverability setup, compliance work and message review that a retainer would usually include.

The video's frames are animations, a typed command and a mock invoice. None shows a real Harvey run, a sent email or a reply thread.

Bottom line

Harvey is a real, MIT-licensed outreach agent with a sensible default: nothing sends until you approve it. Budget for a sending domain, a mailbox, 2 to 4 weeks of warmup and possibly paid lead data. Running it at volume on a Claude subscription may run into Anthropic's usage terms.

Sources

Published October 28, 2026. Based on a TikTok by @jackroberts____. Full video notes (markdown)