# Show HN: MailScope – Catch and lint your app's dev emails locally on a Mac

> Source: <https://mailscope.app/>
> Published: 2026-11-18 13:59:17+00:00

**Key takeaway:** MailScope runs a local SMTP server on 127.0.0.1:1025 (host.docker.internal for Docker) that lints captured dev emails for unrendered {{variable}} placeholders, missing cid: attachments, empty href/src values and missing text/plain parts, and its optional read-only MCP server lets assistants like Cla

Native email debugging for Mac

# See the email before your users do.

Point your app at MailScope and every development email lands on your Mac, checked for mistakes the moment it arrives.

Founding price · First 20 licences · Regular ~~$29~~

Founding licences gone? [Get the early supporter price — $19](https://buy.stripe.com/3cI4gz84B1mufem9MU08g0g?prefilled_promo_code=EARLY)

One-time USD payment · 2 Macs · 12 months of updates

For macOS 14 or later. Your covered versions are yours to keep.

## Mistakes it flags on arrival

MailScope checks every captured email on your Mac, without AI or network requests. The inbox shows how many findings each message has, and the Checks column explains each one, most serious first.

### Problems

Things a recipient would notice.

- **Unrendered template variable** Placeholders like`{{first_name}}` left in the email.
- **Missing embedded image** A`cid:` image with no matching attachment.
- **Empty link or image URL** An`href` or`src` with nothing in it.
- **Image has no source** An`img` without`src` or`srcset` .

### Warnings

Likely to cause trouble somewhere.

- **Missing subject** The message was sent without one.
- **Missing plain-text alternative** HTML only, with no`text/plain` part.
- **Uncheckable URL** Relative links, or URLs with embedded credentials.

### Suggestions

Worth fixing before launch.

- **Image has no alt attribute** Add alt text, or`alt=""` for decorative images.

### Links and images, when you ask

Choose which URLs to test and MailScope checks that they respond. It sends HEAD requests without cookies or credentials and reports redirects without following them, so nothing is fetched until you select it.

Inside MailScope

## A closer look at the app

From the first captured email to the details that need fixing.

Select a view. Click to explore.

## Point your app here

MailScope runs an SMTP server on your Mac. Use it in place of your development mail settings.

1. Open MailScope. The inbox shows when SMTP is running.
2. Copy the settings for your setup into your app.
3. Send a test email as usual. It appears in MailScope and goes nowhere else.

### This Mac

```
Host  127.0.0.1
Port  1025
Auth  none
TLS   off
```

Works with Node, Rails, Django, Laravel and anything else that sends over SMTP. If you change the port in MailScope, use that port here too.

### Docker

```
Host  host.docker.internal
Port  1025
Auth  none
TLS   off
```

First turn on **Allow Docker connections** in MailScope’s SMTP settings. No port publishing is needed. Other devices on your network can then reach the capture server too, so use it on a trusted network and turn it off when you’re done.

### Laravel

```
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_SCHEME=null
```

Paste into your development `.env`, run `php artisan config:clear`, and restart any queue workers. MailScope’s **Copy Laravel .env** button fills in your current port, with a Docker version too.

## Every width, light and dark

Each size changes the real WebKit viewport, so your media queries respond the way they would on a phone.

- Desktop
- Fits the window
- Mobile
- 390 px
- Tablet
- 768 px
- Light or dark
- Remembered between launches

These are viewport previews, not simulations of Gmail, Outlook or a phone’s mail app.

## Let your coding assistant read the inbox

Turn on MailScope’s MCP server and assistants like Claude Code can wait for the email your code just sent, read it, and run the same local checks.

- **Read-only.** Assistants can list, wait for and read captured email. They can’t send or delete.
- **Only on this Mac.** The server listens on`127.0.0.1` and needs an access token.
- **Off until you turn it on.** Copy the configuration from Settings when you want it.

Sign up a test user and check the welcome email.

The welcome email still says `{{first_name}}` in the subject and heading. The signup handler isn’t passing the user’s name to the template. I’ll fix that and send it again.

## Safe with real-looking test data

### Never relayed

Captured email stays in MailScope. Nothing is forwarded to real recipients.

### Remote content blocked

Images, fonts and tracking pixels load only when you choose. Scripts never run in previews.

### Links checked on request

No URL is contacted until you select it, and checks send no cookies or credentials.

### Risky attachments flagged

Executables and installers are blocked. Files that can run code ask before opening.

MailScope for Mac

## One payment.

Two Macs.

Keep using the versions your licence covers for life. Your purchase includes 12 months of updates from payment, including major versions released during that year.

[How the licence works](#licence-faq) · [Purchase terms](https://mailscope.app/terms/) · [Seven-day refund, no reason required](https://mailscope.app/refund/)

### Founding price

$9 USDRegular ~~$29~~

First 20 licences

One-time payment. No subscription.

[Buy MailScope — $9](https://buy.stripe.com/3cI4gz84B1mufem9MU08g0g?prefilled_promo_code=FOUNDING)

Founding licences gone? [Get the early supporter price — $19](https://buy.stripe.com/3cI4gz84B1mufem9MU08g0g?prefilled_promo_code=EARLY)

The discount is prefilled at checkout. Review the total before paying.

## Your licence

## Can I try MailScope before buying?

Yes. [Download the seven-day free trial](https://download.visualdevstudio.com/mailscope.dmg). It starts on first launch, needs no key or account, and makes no store requests. Reinstalling does not reset it. When it ends, new capture and MCP stop; you can still view, search, export and delete saved mail. MailScope needs macOS 14 or later, on Apple silicon or Intel.

## How does the licence work?

MailScope is a one-time purchase, not a subscription. One licence covers two Macs. Any version your licence covers keeps working forever, offline included. Each Mac needs an internet connection for initial activation; opening the app then checks the saved licence locally and never waits for the store.

## What happens when my updates end?

Your purchase includes 12 months of updates from purchase, including major versions released during that time. Covered versions keep working after the year ends. If you install a newer, uncovered build, MailScope won’t open your mail and offers the latest included download instead. Your mail is never deleted.

## Can I move my licence to another Mac?

Yes. Choose Deactivate This Mac in Settings → License on the old Mac, then activate the new one. If the old Mac is lost or no longer starts, release it from [your store account](https://store.visualdevstudio.com/account). There is no waiting period between releases. Migration Assistant needs one re-activation on the new Mac; nothing is deleted.

## How do I renew my updates?

Renewal is optional and costs 50% of the regular product price (currently US$29). Renew from [your store account](https://store.visualdevstudio.com/account). It is the same price for every customer, including founding buyers. Renewing early adds 12 months to your current update end date. Renewing after a gap gives 12 months from the renewal date, with no charge for the gap.

## What if I lose my licence key?

Sign in to [your store account](https://store.visualdevstudio.com/account) with the email address you purchased with to view your key, manage Macs and find covered downloads and orders. Your store purchase email also includes a licence PDF. If you cannot access your purchase, email [\[email protected\]](https://mailscope.app/cdn-cgi/l/email-protection#6c1f191c1c031e182c010d05001f0f031c09420d1c1c) with your purchase email address.

## Can I get a refund?

Request a full refund within seven days of purchase by emailing [\[email protected\]](https://mailscope.app/cdn-cgi/l/email-protection#0774727777687573476a666e6b746468776229667777). No reason is required. A refund revokes the licence and the key stops working; MailScope won’t open mail with that key once it learns of the revocation. Captured mail is never deleted. See the [refund policy](https://mailscope.app/refund/) for details.

## What happens during a payment dispute?

An open payment dispute suspends the licence until it is resolved. Once MailScope learns of the suspension, it won’t open mail with that key. Captured mail is never deleted. An offline Mac learns about a suspension or refund when it next contacts the store.

## Questions

## Does it show how Gmail or Outlook will render my email?

No. Previews use WebKit at real viewport widths. They don’t simulate any particular email client. Use MailScope to catch content and template mistakes early, and a client-testing service when you need exact rendering.

## Do the checks guarantee my email will be delivered?

No. Local checks look for common content mistakes. They don’t validate every HTML rule or predict spam filtering or deliverability.

## Does it need an account or an internet connection?

Capture, preview and local checks work offline, and the trial needs no account. Each licensed Mac needs an internet connection for initial activation. Activated Macs can check for updates weekly; turn off automatic checks in Settings → Updates to stop background store requests. Selected link checks and remote content also contact the network. See the [privacy policy](https://mailscope.app/privacy/) for details.

## What if port 1025 is already in use?

MailScope tells you and offers a nearby free port in one click. Change the port in your app to match, or use the copy buttons, which always include the current port.

## Which MCP clients work with it?

Any client that supports Streamable HTTP and a custom Authorization header. Choose **Copy MCP Configuration** in Settings and add it to your assistant. The tools are `get_smtp_status`, `list_emails`, `wait_for_email`, `get_email` and `run_local_checks`.
