Allows an AI client to manage RSS and Atom feeds, search entries, and organize content using a SQLite backend.
Also known as crunchtools/mcp-feed-reader, mcp-feed-reader, mcp-feed-reader-crunchtools
- Stars
- 0
- Tools
- 17
- Downloads, 30 days
- 759
- Latest version
- 0.1.2
- Last commit
- Nov 14, 2026
- License
- AGPL-3.0
What is Feed Reader MCP?
Feed Reader allows an AI client to manage RSS and Atom feeds, search entries, and organize content using a SQLite backend. It exposes 17 tools, such as add_feed_tool, list_feeds_tool, get_feed_tool.
Summary generated from the project's README
About Feed Reader MCP server
MCP Feed Reader provides a way for AI clients to interact with RSS and Atom feeds through a local SQLite backend. Developers can use this server to manage subscriptions, search through content, and organize information into categories. It supports installation via uvx, pip, or Podman containers, and allows for custom database paths through the FEED_READER_DB variable. It also respects standard HTTP proxy settings to help navigate rate limits from certain publishers.
The server includes seventeen specific tools for managing the lifecycle of feeds and entries. Users can add or delete feeds, create and rename categories, and perform full-text searches using FTS5. Because the server does not crawl content automatically, it requires an external trigger like a systemd timer or the --fetch command to update the cache. This ensures that the local database stays current with new publications from the configured sources.
What you can do with it
- 1Manage feed subscriptionsAdd new RSS URLs to the database or remove existing ones using specific management tools.
- 2Search through saved contentPerform a full-text search across all stored entries to find specific topics or keywords.
- 3Organize entries into categoriesCreate new categories and move content to keep the feed reader organized.
- 4Migrate feed collectionsMove existing subscriptions into the server by importing an OPML file.
Written from the project's README. Every use case is checked against a quote from it.
How to install Feed Reader MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Feed Reader MCP in Claude Code
$ claude mcp add mcp-feed-reader -- uvx mcp-feed-reader-crunchtoolsInstall Feed Reader MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-feed-reader": {
"command": "uvx",
"args": [
"mcp-feed-reader-crunchtools"
]
}
}
}Install Feed Reader MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-feed-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-feed-reader-crunchtools"
]
}
}
}Install Feed Reader MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-feed-reader","type":"stdio","command":"uvx","args":["mcp-feed-reader-crunchtools"]}'Install Feed Reader MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-feed-reader": {
"command": "uvx",
"args": [
"mcp-feed-reader-crunchtools"
]
}
}
}Install Feed Reader MCP in Codex
$ codex mcp add mcp-feed-reader -- uvx mcp-feed-reader-crunchtoolsInstall Feed Reader MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-feed-reader] command = "uvx" args = ["mcp-feed-reader-crunchtools"]
Install Feed Reader MCP in Gemini CLI
$ gemini mcp add -s user mcp-feed-reader uvx -- mcp-feed-reader-crunchtoolsInstall Feed Reader MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-feed-reader": {
"command": "uvx",
"args": [
"mcp-feed-reader-crunchtools"
]
}
}
}Feed Reader MCP tools 17
Detected from the READMEadd_feed_toollist_feeds_toolget_feed_tooldelete_feed_toolrefresh_feeds_toollist_entries_toolread_entry_toolmark_read_toolmark_unread_toolsearch_entries_toollist_categories_toolcreate_category_tool
| add_feed_tool | — | |
| list_feeds_tool | — | |
| get_feed_tool | — | |
| delete_feed_tool | — | |
| refresh_feeds_tool | — | |
| list_entries_tool | — | |
| read_entry_tool | — | |
| mark_read_tool | — | |
| mark_unread_tool | — | |
| search_entries_tool | — | |
| list_categories_tool | — | |
| create_category_tool | — |
Show all 17 toolsShow fewer tools
rename_category_tooldelete_category_toolimport_opml_toolexport_opml_toolget_stats_tool
| rename_category_tool | — | |
| delete_category_tool | — | |
| import_opml_tool | — | |
| export_opml_tool | — | |
| get_stats_tool | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablecrunchtools/mcp-feed-reader is public and reachablegithub.com/crunchtools/mcp-feed-reader ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Sigstore attestation for mcp-feed-reader-crunchtoolspypi.org/project/mcp-feed-reader-crunchtools/ ↗Pass
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/crunchtools/mcp-feed-reader ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from mcp-feed-reader-crunchtoolsPass
- No critical advisory in the package or its dependencies67 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubmcp-feed-reader-crunchtools
Secure MCP server for RSS/Atom feed reading with SQLite backend.
Installation
uvx (recommended)
uvx mcp-feed-reader-crunchtools
pip
pip install mcp-feed-reader-crunchtools
Container
podman run -v feedreader-data:/data quay.io/crunchtools/mcp-feed-reader
Configuration
| Variable | Default | Description |
|---|---|---|
FEED_READER_DB |
~/.local/share/mcp-feed-reader/feeds.db |
SQLite database path |
HTTP_PROXY / HTTPS_PROXY / NO_PROXY |
(none) | Standard httpx proxy variables, honoured for every feed fetch. Useful when a publisher rate-limits your egress IP — Reddit returns 429 to datacentre ranges regardless of User-Agent |
Tools (17)
Feed Management
add_feed_tool— Add an RSS/Atom feed by URLlist_feeds_tool— List all feeds with unread countsget_feed_tool— Get feed detailsdelete_feed_tool— Remove a feedrefresh_feeds_tool— Crawl feed sources for new content (slow, prefer systemd timer)
Entry Management
list_entries_tool— List entries (filterable, paginated)read_entry_tool— Read full entry content (auto-marks read)mark_read_tool— Mark entries as readmark_unread_tool— Mark entry as unreadsearch_entries_tool— Full-text search (FTS5)
Category Management
list_categories_tool— List categories with countscreate_category_tool— Create categoryrename_category_tool— Rename categorydelete_category_tool— Delete category
Import/Export
import_opml_tool— Import from OPML fileexport_opml_tool— Export as OPMLget_stats_tool— Dashboard stats
Background Fetching
Nothing in the server crawls on its own. list_entries_tool and friends read a
cache; if no one calls --fetch, that cache goes stale and every reader sees an
empty feed with no error anywhere. A deployment without a crawl trigger is a
broken deployment — this bit the daily briefing, which reported "no news" for
days while all 61 feeds sat unfetched.
# Fetch all feeds via CLI
mcp-feed-reader-crunchtools --fetch
systemd timer (recommended)
deploy/ ships the two units used in production. Copy them to
/etc/systemd/system/, adjust the container name in the service if yours
differs, then:
sudo systemctl daemon-reload
sudo systemctl enable --now mcp-feeds-refresh.timer
The service runs --fetch inside the running container
(podman exec), so the database keeps the SELinux category of the process that
owns it. Do not bind-mount the data directory into a second container with
:Z to run the crawl — that relabels the volume and locks the live server out.
The timer fires hourly, plus once at 05:45. That second entry is not redundant: consumers window entries on publication time, so an entry published between the last crawl and a 06:00 report is missing from that report and already older than the next day's window start — it is lost for good. Any consumer on a fixed schedule wants a crawl shortly before it.
Feeds are fetched conditionally (ETag / If-Modified-Since). A rate limit,
gateway 5xx, or dropped connection is retried with exponential backoff, up to
three attempts in all, before the feed is recorded as failed.
License
AGPL-3.0-or-later
Feed Reader MCP questions
How do I add Feed Reader MCP to Claude Code?
Run claude mcp add mcp-feed-reader -- uvx mcp-feed-reader-crunchtools in your terminal. Add --scope user to make it available in every project.
How do I add Feed Reader MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Feed Reader MCP provide?
It exposes 17 tools, including add_feed_tool, list_feeds_tool, get_feed_tool, delete_feed_tool, refresh_feeds_tool.
Does the server automatically crawl feeds?
No, the server does not crawl on its own; you must trigger a fetch via the CLI or a scheduled task like a systemd timer to prevent the cache from going stale.