Likelyread MCP server

likelyread

Open-source email open tracking for Gmail. It tells you when someone opens an email you sent, explains why each open counted, and gives you a small dashboard to follow your campaigns.

Two ways to use it:

• Likelyread Cloud at app.likelyread.com: install the Chrome extension, sign in with Google, done. Free plan; Pro adds campaign analytics and full history. See docs/CLOUD.md.
• Self-hosted: one small server (FastAPI + SQLite) behind Caddy, installed with one command. One token, every feature, nothing leaves your VPS. Instructions below.

How it works

1. When you click Send in Gmail with tracking on, the extension appends a 1x1 invisible image (https://your-domain/p/.gif) to the email and registers the email with your server. Sending is never blocked or delayed.
2. When the recipient's mail client loads the image, the server logs a hit.
3. Hits are classified when you read them:

• self: your own compose preview or your own view of the sent email (the extension tells the server, and also blocks the request in your browser);
• prefetch: Apple Mail Privacy Protection loading images on delivery (bare Mozilla/5.0 user agent from Apple's network);
• open: everything else.

1. You see the result where you look:

• in Gmail, next to the date of each tracked email you sent, when you open the conversation: one grey tick while nobody has opened it (Not opened yet, Seen by you only, Prefetch only), two red ticks once someone has (Opened ×2). Hover for when; click to open the email in the dashboard;
• in the toolbar popup, the last 50 tracked emails with their status;
• on the dashboard, everything (see below).

See SPEC.md for the full contract.

Setup

You need a small Linux server (Ubuntu or Debian, 512 MB of RAM is plenty) with ports 80 and 443 open.

1. Pick an address. Use a subdomain of a domain you own, for example t.yourcompany.com: add an A record pointing to the server's IP (on Cloudflare, set it to DNS only, grey cloud). No domain yet? The installer can use a free .sslip.io address to try it out. For real email use your own domain: spam filters trust it more, and it keeps working if you move servers.

2. Run one command on the server:

curl -fsSL https://raw.githubusercontent.com/Hugo-SEQUIER/likelyread/main/deploy/install.sh | sudo bash

It installs Docker if needed, asks for your address, creates a private token, gets an HTTPS certificate and starts everything in /opt/likelyread. At the end it prints your setup link:

https://t.yourcompany.com/#connect=<your token>

Treat it like a password. You can print it again any time with sudo bash /opt/likelyread/deploy/install.sh --show-link, and it is on the dashboard under Connect.

3. Connect the extension. Install the Chrome extension, open its settings, paste the setup link and click Save. Write an email in Gmail: the red eye next to Send means it is tracked, and after you send it a note at the bottom left says Tracked by Likelyread. To try it, send it to another address you can open, such as a second account or your phone: your own views never count, so an email you send yourself stays Seen by you only.

Get the extension from the Chrome Web Store. To run your own build instead: cd extension && npm install && npm run build, then in chrome://extensions turn on Developer mode, click Load unpacked and pick extension/dist.

4. Open the dashboard. Open the setup link in your browser: it signs you in.

Shortened. The full README is on GitHub.