Local-first · MIT licensed · agent-ready

Subscribe once.
Read by email or over MCP.

Antenna stores your feed subscriptions in one local SQLite index, then routes new posts to email and to AI agents over MCP from the same data. No vendor cloud. No proprietary lock-in. Your subscription graph lives in a file you control.

View on GitHub Install locally

v0.1.1 · Phase 0 (personal, local) · Python 3.12+ · macOS / Linux

Your subscriptions live in a UI your agent can't query.

RSS-to-email went stale.

The incumbents drift into ads, dated layouts, forced tracking, and opaque delivery rules. You pay with your inbox.

Agents can't read your reading list.

Your subscription graph is trapped behind someone else's web UI. Your agent can't search it, cluster it, or summarize it on your behalf.

Your data isn't yours.

Export is an afterthought. Your attention graph ships to whichever vendor bought the last one.

One subscription graph. Two first-class outputs.

Email

Clean per-post or digest HTML. Sent via your own SMTP (Amazon SES, Postmark, Gmail app password — your call). No third party reads your subscriptions.

  • Per-post or digest mode, toggleable per run
  • Rule engine: include / exclude / alert for immediate promotion
  • Deduplication across polls by the feed's stable entry ID
  • Conditional GET with ETag and Last-Modified — feeds don't re-ship content that hasn't changed
  • Relative URLs rewritten to absolute; YouTube shortcodes recovered as email-safe thumbnail links
  • Dry-run writes an HTML preview to an outbox for QA before anything leaves SMTP

MCP (agent protocol)

Antenna speaks MCP over stdio. Six tools the moment you flip the server on — any MCP client can call them.

  • list_sources surfaces each feed's last_polled_at and last_error so agents can reason about feed health
  • subscribe validates the URL with an immediate fetch and returns the post count so the agent knows the feed is live
  • search_posts returns FTS5-highlighted snippets; get_post returns the full HTML plus plain-text on demand
  • recent_posts · unsubscribe round out the surface
  • Backed by the same SQLite index your email uses

“Using the antenna tools, search for everything from the last 7 days tagged robotics that mentions Gemini, and summarize the three most interesting ones.”

— an agent prompt that just works, because your subscriptions are data you control

Install the package, import OPML, start polling from your own SQLite.

  1. Install

    python3 -m venv ~/antenna/.venv
source ~/antenna/.venv/bin/activate
pip install -e .

  2. Migrate your feeds

    antenna import-opml ~/Downloads/feedly.opml
antenna -v fetch

    Blogtrottr, Feedly, Inoreader — whichever reader you're leaving, export OPML and walk it over in one command. First-run entry cap keeps you from getting flooded by the backlog.

  3. Email yourself what's new

    antenna send-email --mode per_post --dry-run   # preview to outbox/
antenna send-email --mode per_post              # real

  4. Plug into your agent

    // Claude Desktop MCP config fragment
// Substitute /Users/YOU with your actual home directory.
{ "mcpServers": {
    "antenna": {
      "command": "/Users/YOU/antenna/.venv/bin/python",
      "args": ["-m", "antenna.cli", "serve-mcp"],
      "env": {"ANTENNA_CONFIG": "/Users/YOU/antenna/antenna.yaml"}
}}}

  5. Schedule it

    launchctl load ~/Library/LaunchAgents/com.antenna.fetch.plist

    Polls every 15 minutes. Emails only truly-new posts. Logs to ~/antenna/logs/.

Get the code

Phase 0 is public on GitHub now. Clone main for the latest verified build, or use the v0.1.1 release if you want a pinned source snapshot. The full install guide, config reference, and smoke-test script live in the repo README. The waitlist below is for hosted Phase 1 updates and direct product follow-up, not to unlock the local package.

Open the repo Pinned release v0.1.1

Built agent-first, not agent-last.

Other readers bolt on an API and call it a day. Antenna's entire data model exists to be queried by software — humans and agents both read from the same SQLite.

Single source of truth

Your inbox and your agent query the same table. No sync lag, no divergent indexes, no "why didn't the agent see the post I just read?"

FTS5 is the API

Every post hits a SQLite FTS5 virtual table on write. Boolean, phrase, and prefix search come free — and search_posts returns highlighted snippets out of the box.

Stable IDs, honest dedup

Deduplication is by the feed's stable entry ID, not by URL hashes that drift. An agent searching twice gets the same row, not two.

MCP today. HTTP next.

Stdio MCP ships in v0.1. An HTTP surface lands when Phase 1 opens; same tools, hosted for you.

Honest roadmap

Today — Phase 0

Personal, local, yours.

  • Fourteen CLI subcommands; six MCP tools over stdio
  • Email + MCP are the only outputs
  • Single user per install; no auth, no web UI
  • MIT licensed; public GitHub repo plus a pinned source release
Next — Phase 0.5

Sharper primitives.

  • Webhook output adapter
  • Per-feed rule UI (no more YAML for rules)
  • Alert throttling
Later — Phase 1

Hosted, multi-user.

  • antennafeed.com hosted service
  • OAuth + shared OPML import
  • HTTP MCP surface, same tools

Stay in the loop.

Phase 0 is public today. Join the waitlist if you want hosted Phase 1 updates, a direct follow-up from Codex working with Todd, or a note when the email path gets easier for non-operators.

We store your email, source IP, user-agent, plus any utm_source, utm_medium, utm_campaign, and referrer from your browser in DynamoDB, then send a direct follow-up from Codex working with Todd. If you do not reply, we may send one short check-in. No third-party trackers. See our privacy notes.