MailFeed

Your reading list, owned by you.

Turn your emails into a personalized reading feed with full-text content, semantic search, and smart link extraction.

“If you've ever emailed yourself before, this app is for you.”

“I mean, doesn't everyone do this?” — David

“Another read-it-later app shut down and took my whole library with it. Never again.”

— David, after losing his bookmarks for the third time

“I already email myself links. Why not just turn that into the whole app?”

— David, at 2 AM, convincing himself to build this

“I miss RSS readers. I miss Google Reader. I will not let go.”

— David, mass-replying to everyone who said RSS is dead

MailFeed is for you.

Email yourself a link. MailFeed turns it into a full-text reading feed with search and smart extraction.

Get StartedSelf-Host

Features

Gmail Integration

Syncs emails you send to yourself. Just email yourself a link and MailFeed picks it up.

Smart Link Extraction

Automatically finds, deduplicates, and follows redirects to surface the real URLs.

Content Fetching

Fetches full articles with Mozilla Readability. Detects paywalls and falls back to archives.

Reading Feed

Clean, organized feed with filters, search, categories, and reading time estimates.

Semantic Search

Chat with your saved links using vector embeddings and RAG-powered search.

Coming Soon

AI Summaries

AI-powered summaries, key points, categorization, and worthiness scores for every link.

Self-Host MailFeed

Run it on your own machine. Your data stays with you.

Run this single command in Terminal. It installs Docker, clones the repo, and walks you through entering your API keys.

curl -fsSL https://raw.githubusercontent.com/toothbrush-inc/mailfeed/main/scripts/setup.sh | bash

macOS only. Requires an internet connection. The script will prompt you for Google API credentials.

Details & prerequisites

What the script does

  1. Checks for (or installs) Homebrew, Docker Desktop, and Git
  2. Clones MailFeed into ~/mailfeed
  3. Creates .env and generates a secure secret
  4. Prompts you for Google OAuth credentials (and optionally a Gemini API key)
  5. Starts the app with Docker Compose at http://localhost:3000

Google Cloud setup

The script will ask for your Google credentials (the Gemini key is optional). Follow our step-by-step guide for detailed instructions with screenshots, or use the quick links below:

  1. Create a project in Google Cloud Console
  2. Enable the Gmail API
  3. Create OAuth 2.0 credentials (Web application) with redirect URI: http://localhost:3000/api/auth/callback/google
  4. (Optional) Get a Gemini API key from Google AI Studio — enables AI semantic search

Don't want to self-host?

We're considering a hosted version so you don't have to manage anything yourself. If that sounds interesting, let us know!

I'd use a hosted version