Feeds & folders
Subscribe to RSS and Atom feeds, discover them automatically and organize them into folders.
Open Source / RSS + MCP
FeedKeeper.
Your sources. Your pace. Your server.
FeedKeeper brings RSS and Atom feeds into a focused web reader. Own your subscriptions, read on any screen and connect your news to AI tools when you choose — no cloud account required.
01 // The Reader
Everything in view. Nothing in the way.
FeedKeeper helps you find and organize sources, read online and offline, and keep important articles for later.
Read articles
Choose list or magazine view on larger screens; phones use magazine view. Search and read status are built in, with full-text fetch on demand.
Lasting archive
Saved articles retain their full text and images, even if the source removes them later. You can still search them.
Read offline
Saved and the newest unread articles stay on your device with text and images. Read and save changes are sent when you reconnect.
Notifications & app icon
Push notifications for new articles are optional per feed and device. The unread count on the app icon can also be enabled per feed. On iPhone and iPad, add the web app to the home screen first; push uses your browser's service.
Keyword filters
Mute articles about unwanted topics with your own keywords.
Easy to move
Import or export subscriptions with OPML. Your sources stay portable.
MCP for AI tools
Personal tokens give compatible AI tools read-only or read-write access to your feeds.
Self-hosting & backups
One Node.js process, SQLite and an archive folder on your server. Accounts stay isolated; backups include the database and archived images.
02 // The Interface
A feed that follows your lead.
Use the web app in a browser or add it to your home screen. Previously loaded content opens offline; pending changes are sent and your devices sync when you reconnect.
03 // Architecture
Small footprint. Full control.
FeedKeeper runs on your own server or Raspberry Pi. The web UI, feed polling and MCP endpoint live in one process. Feeds, accounts and articles are stored in SQLite, with archived images in a folder beside the database.
01
Web UIYour reader in the browser, on desktop and mobile.
02
Node.js + MCPFeed polling, API and authenticated access for AI tools.
03
SQLite & archiveOne local file for feeds, articles and accounts, plus a folder for archived images. Backups include both.
04 // Installation
Up and running in a few commands.
Docker Compose pulls the prebuilt image for amd64 or arm64 and starts FeedKeeper without a local build. Then open http://localhost:3000 to create your first account.
Guide on GitHubfeedkeeper / docker
mkdir feedkeeper && cd feedkeeper
curl -fsSLO https://raw.githubusercontent.com/visualfusion/feedkeeper/main/compose.yaml
echo "SESSION_SECRET=$(openssl rand -hex 32)" > .env
docker compose up -d↳ http://localhost:3000
These commands download compose.yaml and generate a random SESSION_SECRET in .env. Before making the instance public, set PUBLIC_URL in .env to your domain.
MIT / OPEN SOURCE