Today
What's waiting on you, and how the pipeline is moving.
Signals
Msquad Outreach proposes what it knows how to look for. You decide what actually defines a good prospect — nothing is collected until you confirm it.
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.
Companies
Organizations Msquad Outreach has researched. Click a row to see its contacts.
Contacts
People Msquad Outreach has found, how sure it is of their address, and where each one stands.
Deals
Enquiries and quotes, from first ask to won or lost. Set a follow-up date and it shows on Today.
Campaigns
Email sequences Msquad Outreach has written, and how far each one has got.
Custom email templates
Saved drafts for the OutboxWrite the subject and body you want. Use {{first_name}}, {{company}}, or {{title}} for each recipient. Applying a template always sends drafts back for review.
Outbox
Emails waiting for you. Read one, decide, move on — A approve, R reject, E edit, J/K to move.
Conversations
Every reply, and how Msquad Outreach handled it.
Activity
A running log of every action Msquad Outreach's agents have taken.
Usage
Model usage on your subscription (Claude or Codex): calls and tokens by provider, agent and task. Subscription plans aren't billed per token, so there are no dollar costs here.
Settings
Credentials are stored locally in .env and never sent anywhere except the services themselves.
Your business and product
These settings are saved in harvey.local.yaml and survive Docker restarts. Restart Msquad Outreach after changing them.
Where your company operates from. Target locations below control where Msquad Outreach looks for prospective customers.
Msquad Outreach adds the sender name, company, mobile, email and website under cold emails. Zoho Mail displays the logo when images are allowed.
Repeats every week in the operator time zone above. Approved outreach and replies wait outside these hours; Msquad Outreach can still process incoming mail when its heartbeat runs.
This changes Msquad Outreach's analysis and writing model. Company search uses the source selected in Discover. Restart Msquad Outreach after saving.
These addresses may bounce. Msquad Outreach shows a warning in Outbox and still requires your approval; invalid and unverified addresses remain blocked.
Advanced configuration
Edit the complete YAML settings when you need fields beyond this form.
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 and secret, save, then run harvey gmail auth.
Zoho Mail MCP
Paste the URL from your Zoho MCP server's Connect page. Click Connect Zoho, sign in on Zoho's page, and return here. The server needs getMailAccounts, getAllFolders, listEmails, getMessageContent, sendEmail and sendReplyEmail. Click Test to see which tools are missing.
SMTP + IMAP mailbox (password fallback)
Any real mailbox, including Zoho Mail. For Zoho personal/free accounts use smtp.zoho.com and imap.zoho.com; for paid custom-domain accounts use smtppro.zoho.com and imappro.zoho.com. Use ports 587 (SMTP) and 993 (IMAP), and check your Zoho account's exact server details. Zoho setup guide.
Reading replies from a different IMAP server or login
Microsoft 365 / Outlook
In Microsoft Entra → App registrations, register an app for this organization. Under Authentication, add a Web redirect URI: /api/settings/microsoft/callback. Add delegated Microsoft Graph permissions Mail.ReadWrite, Mail.Send, and User.Read. Under Certificates & secrets, create a client secret and copy its Value. Save the three fields, then click Connect Microsoft.
Instantly Legacy
Get your API key from Instantly Settings → Integrations (Growth plan or higher for API).
OpenStreetMap (Overpass) not tested
Searches mapped physical business types. Public Overpass servers may be unavailable; use your own or a hosted server URL for reliable runs. Online-only businesses need web search.
Self-hosted search (SearXNG)
Runs in Docker on this computer. Searches external engines without a paid search API key; results may be limited when an engine blocks automated requests.
Qwen website extraction
When normal page parsing finds no named contacts, Qwen looks for people and roles in fetched company pages. Msquad Outreach accepts only details present on the cited page. Crawl4AI also retries thin JavaScript pages, up to two sites per cycle.
2GIS Places
Searches the 2GIS business directory by trade and city. Create a Places API key in the 2GIS Platform Manager. API usage follows your 2GIS plan.
Serper
Google search discovery. Create a key at serper.dev, then paste it here.
DataForSEO
Business listings, organic rank and Google Maps. Use the API login and password from DataForSEO API access.
Verifiers
Zoho Mail is your sending and receiving mailbox. These services check whether a prospect's address is deliverable. Connecting Zoho does not verify addresses you found; without a verifier they stay guess and are never sent.
This keeps saved API keys but stops Msquad Outreach using them for new address checks. Many hosted mailboxes will remain unconfirmed. Save, then restart Msquad Outreach in Controls.
Built-in checks use DNS and, where reachable, SMTP recipient tests. An exact address published on the company's own website can be marked risky when its mail domain works; this does not confirm the mailbox. Generated address guesses stay unconfirmed. Sending risky addresses requires your separate opt-in. This check sends no email.
For automated LinkedIn prospecting. Msquad Outreach logs in and searches like a human.
Cloudflare
Optional deep website crawling with JavaScript rendering during product training. Cloudflare Browser Run has a free tier with usage limits.
Controls
Start and stop Msquad Outreach's heartbeat loop, and watch what it's doing.
Agent
Recent logs
Help
What Msquad Outreach is, how it works, and how to fix the usual problems.
What is Msquad Outreach?
Msquad Outreach is an autonomous AI sales agent. Once set up, Msquad Outreach 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.
Choose a Claude or ChatGPT subscription, or add a Claude or OpenAI API key in Settings. API providers bill according to your provider account. Your portal data is stored on this server.
Getting started
There are three things to do:
1. Go to the Settings tab and connect an email provider (Gmail recommended) 2. Train Msquad Outreach on your product (through Claude or the command line) 3. Go to the Controls tab and click Start
Today shows exactly what's done and what still needs to happen.
Where everything lives
Everything Msquad Outreach needs is inside this one project folder. Nothing is stored elsewhere.
| .env | Your API keys and credentials (never shared or committed) |
| harvey.yaml | Your product info, target customers, and behavior settings |
| skills/ | Sales knowledge files. Edit these to change how Msquad Outreach writes and sells. |
| skills/product_knowledge.md | Everything Msquad Outreach knows about your product (auto-generated from training) |
| prompts/ | Prompt templates for each agent. Advanced customization. |
| data/harvey.db | Database with all prospects, campaigns, and conversations |
| data/harvey.log | Log file showing what Msquad Outreach is doing |
Getting your API keys
Instantly API key (legacy)
Instantly is the legacy sending option; Gmail or SMTP is recommended.
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 Msquad Outreach to find prospects on LinkedIn, enter your LinkedIn email and password. Msquad Outreach uses a real browser to search LinkedIn like a human would, with random delays and rate limits to avoid detection.
If you skip this, Msquad Outreach will find prospects through Google searches and company website scraping instead.
Cloudflare Browser Run (optional)
This is only used during product training (when Msquad Outreach crawls your website to learn about your product). It handles JavaScript-heavy websites that a basic crawler can't read.
1. Sign in at Cloudflare. Browser Run has a free tier.
2. Open My Profile > API Tokens > Create Token > Create Custom Token.
3. Grant Account > Browser Run > Edit for the account you will use, then create and copy the token.
4. In Cloudflare, search for “Copy account ID”; enter that ID and the token in Settings > Cloudflare.
Without this, Msquad Outreach uses a built-in crawler that works fine for most websites but can't render JavaScript.
Common issues
"command not found: harvey"
source .venv/bin/activateInstantly API returns 401
Claude headless mode fails
claude login in your terminal and have an active Claude Max subscription. Msquad Outreach uses your existing subscription, not a separate API key.Codex calls fail
brain.provider: codex, set brain.model to an available model ID, including Luna, Sol, or Terra (for example gpt-6.1-sol), or leave it blank to select a listed model. Msquad Outreach runs these models without tools; gpt-5.5 also remains supported when present in your account's catalog. Run codex login and choose "Sign in with ChatGPT" (API-key logins are refused). Msquad Outreach never renews your Codex login: if the log says it has expired or is due for renewal, use Codex once or run codex login. Msquad Outreach needs Codex CLI 0.159.3 on macOS or Linux (Codex isn't supported on Windows; use Claude there) and refuses other versions. While Codex can't be used, Msquad Outreach pauses (Today shows "Codex is paused" and why), leaves replies and queued emails untouched, and resumes once it's fixed; harvey status --check checks on demand. If the log says isolation could not be verified, a Codex config layer is forcing a tool, hook, MCP server or custom endpoint back on — Msquad Outreach refuses to send prompts until it is removed. Msquad Outreach never falls back to Claude on its own.