Skip to main content
Glama
ReachDirect MCP

ReachDirect MCP

Official
by weblinkify

ReachDirect MCP

Live demo: https://reach-direct-mcp.vercel.app (mock mode, nothing is sent) · deploys automatically on every push to main

An MCP server that lets Claude Desktop, Cursor or any MCP client do personal outreach for you: send an email through Brevo, send a WhatsApp message through WhatsApp Web, and log every contact to an Excel file. You state your name, sender address and message in the chat. Your assistant fills in the template, shows you the final text, and sends it once you say yes.

MCP server

Python 3.10+ · FastMCP · httpx (Brevo v3 API) · Playwright (WhatsApp Web) · openpyxl · phonenumbers

Web demo

React 18 · TypeScript · Tailwind CSS · Vite, deployed on Vercel


Tools

Tool

What it does

preview_message

Fills {{first_name}}, {{name}}, {{company}} and any {{custom}} placeholder, with fallbacks such as {{first_name|there}}. Lists anything still unfilled.

send_email

Sends one email through the Brevo transactional API over HTTPS. You need no SMTP setup or password, only BREVO_API_KEY and a sender address verified in Brevo. dry_run=true validates the email and returns it without sending.

send_whatsapp

Opens WhatsApp Web in a browser and sends one message. On first use, a QR code is saved as an auto-refreshing WhatsApp_Login.html in your output folder; scan it once and the session is kept.

save_outreach_contact

Appends Date, Name, Company, Email, Phone, Channel, Status and Notes to outreach_contacts.xlsx.

list_outreach_contacts

Shows the latest rows of the log.

add_do_not_contact

Records someone who asked not to be contacted. Later sends to that address or number are refused.

Built-in safeguards:

  • Messages with unfilled {{placeholders}} are refused.

  • Email addresses are validated, and phone numbers must parse in international format.

  • Sends are capped per channel per day (REACHDIRECT_DAILY_LIMIT, default 50).

  • WhatsApp messages are URL-encoded, so &, # and line breaks arrive intact.


Related MCP server: mcp-leadgen-orchestrator

Install

git clone https://github.com/weblinkify/reach-direct-mcp
cd reach-direct-mcp
python -m venv .venv && source .venv/bin/activate     # Windows: .venv\Scripts\activate
pip install -e .
playwright install chromium

MCP client config:

{
  "mcpServers": {
    "reachdirect": {
      "command": "/ABSOLUTE/PATH/reach-direct-mcp/.venv/bin/reachdirect",
      "env": {
        "BREVO_API_KEY": "xkeysib-your-key",
        "REACHDIRECT_OUTPUT_DIR": "~/Desktop",
        "REACHDIRECT_DAILY_LIMIT": "50"
      }
    }
  }
}

Variable

Default

Purpose

BREVO_API_KEY

—

Brevo → Settings → SMTP & API → API keys. The free plan sends 300 emails/day.

REACHDIRECT_OUTPUT_DIR

Desktop, else ~/ReachDirect

outreach_contacts.xlsx and the WhatsApp QR page.

REACHDIRECT_STATE_DIR

~/.reachdirect

WhatsApp browser profile, daily counters, do-not-contact list.

REACHDIRECT_DAILY_LIMIT

50

Max sends per channel per day.

REACHDIRECT_BROWSER_CHANNEL

bundled Chromium

Use msedge or chrome to drive an installed browser instead.

Before the first email, verify your sender address or domain in Brevo (Senders, domains & IPs) and set up SPF/DKIM. Otherwise Brevo rejects the send, and the tool tells you why.

Example prompt

I'm Daniel Weber (daniel@weber-parts.example). Write to Marie Laurent
(marie.laurent@laurent-remorques.example, +33 6 12 34 56 78) at Laurent Remorques
about our trailer axle range.
1. preview_message with a short intro, then show me the text.
2. After I approve: send_email, then send_whatsapp with a one-line heads-up.
3. save_outreach_contact for Marie with channel "email+whatsapp".

Web demo

cd frontend
npm install
npm run dev          # http://localhost:5173

You can pick a fictional contact and a template, edit the placeholders and see the email or WhatsApp preview. A mock "send" applies the same validation, do-not-contact and daily-limit rules as the server and logs the attempt. Nothing leaves the browser.

Vercel: import the repo and set Root Directory to frontend; frontend/vercel.json does the rest.

Development

make install   # dependencies and git hooks
make check     # lint, types, tests and build: everything CI runs before merge
make audit     # pip-audit and npm audit

Responsible use

Send one-to-one messages to people with a reason to hear from you, honour opt-outs (add_do_not_contact) and follow the rules where you operate (GDPR / ePrivacy, CAN-SPAM, KVKK). WhatsApp's terms restrict automated and bulk messaging; misuse can get your number banned. This tool sends one approved message per call on purpose.

License

MIT

Available Tools

6 tools
add_do_not_contactAdd Do Not ContactB

Record that someone asked not to be contacted. Future sends to them are refused.

Inputs: email_or_phone (required). Returns: result

list_outreach_contactsList Outreach ContactsC

Latest rows of the outreach log.

Inputs: limit. Returns: result

preview_messagePreview MessageD

Fill {{first_name}}, {{name}}, {{company}} and any extra {{placeholders}} (fallbacks: {{first_name|there}}).

Inputs: template (required), extra, company, recipient_name. Returns: result

save_outreach_contactSave Outreach ContactB

Append a row to outreach_contacts.xlsx (Date, Name, Company, Email, Phone, Channel, Status, Notes).

Inputs: name (required), email, notes, phone, +3 more. Returns: result

send_emailSend EmailB

Send one email through Brevo (needs BREVO_API_KEY and a sender verified in Brevo).

Inputs: message (required), subject (required), sender_name (required), sender_email (required), +4 more. Returns: result

send_whatsappSend WhatsappA

Send one WhatsApp message through WhatsApp Web (a browser window opens; first run asks for a QR scan).

Inputs: message (required), phone_number (required), default_region. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool has a distinct action target: listing rows, previewing templates, sending via two clearly separated channels, appending rows, and recording DNC. Minor blur between list_outreach_contacts (outreach log) and save_outreach_contact (outreach_contacts.xlsx), which appear to touch the same data under different resource names.

    Naming Consistency5/5

    All six names are snake_case verb_noun (list_, preview_, send_, save_, add_) with predictable patterns, including the parallel send_email/send_whatsapp pair.

    Tool Count4/5

    Six tools cover the core read/send/save/suppress flow without bloat. The set is slightly thin — there is no status-update or lookup tool — but each tool clearly earns its place.

    Completeness3/5

    The surface handles listing, templating, sending on two channels, saving, and DNC, but the Status field in the saved row has no update tool, there is no way to remove or inspect DNC entries, and no contact lookup/search or reply tracking. These gaps will leave agents unable to close the loop after a send.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables sending WhatsApp messages through Claude Desktop and other MCP-compatible LLMs. Supports single and bulk messaging, phone number validation, and session management via the zapr.link service.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients such as Claude, ChatGPT, and Cursor to read and search Instagram, WhatsApp, and LinkedIn conversations, find contacts, and spot prospects left without a reply. It can also prepare or send follow-ups, but only within permissions a human grants, and nothing goes out without human approval.
      CC BY-4.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      This MCP server lets coding agents research and score leads, draft cold emails, run every message through CAN-SPAM and deliverability gates, and hold them for human approval while logging why each lead was contacted. It enforces caps, warmup ramps, and a Tuesday/Wednesday send window, and by default never sends anything.
      10 npm
      MIT