imprvhub/mcp-rss-aggregator

An integration that allows Claude Desktop to fetch and read content from your favorite RSS feeds using the Model Context Protocol (MCP).
Features
- Read articles from your favorite RSS feeds directly in Claude Desktop
- Support for OPML files to import your existing feed subscriptions
- Organize feeds by categories
- Get the latest articles across all your feeds
- Filter articles by feed source or category
- Well-formatted article presentation with titles, snippets, and links
- Feeds are read and formatted locally; no article content leaves your machine
Demo
Timestamps
Click on any timestamp to jump to that section of the video
00:00 - **Sample RSS Feed Demonstration**:
Using the default 'sample-feeds.opml' file included in the repository. This segment displays how Claude processes and presents news content from sources like TechCrunch, The Verge, and other technology publications through the MCP (Model Context Protocol).
01:05 - **Configuration File Editing Process**:
Step-by-step walkthrough of accessing and modifying the claude_desktop_config.json file to change the OPML file path reference from the default sample to a customized 'my-feeds.opml' file.
01:15 - **Application Restart Procedure**:
Illustrating the necessary step of closing and reopening the Claude Desktop application to properly load and apply the modified OPML file configuration changes.
01:25 - **Custom RSS Feed Results**:
Demonstration of the results after implementing the custom OPML file. This section highlights the expanded and more diverse news sources now available through Claude Desktop, including Spanish-language content.
Requirements
- Node.js 20 or higher
- Claude Desktop
- Internet connection to access RSS feeds
Installation
Installing via Smithery
Install the packaged bundle from the Smithery server page, or from the CLI:
Installing Manually
1. Clone or download this repository:
2. Install dependencies:
3. Build the project:
Feed Configuration
The RSS Aggregator supports both OPML and JSON formats for feed configuration.
Using OPML (Recommended)
OPML (Outline Processor Markup Language) is a standard format used by most RSS readers to export and import feed subscriptions.
A sample OPML file with popular feeds is included in the public/sample-feeds.opml file. You can:
1. Use this file as-is
2. Edit it to add your own feeds
3. Replace it with an export from your existing RSS reader
Most RSS readers allow you to export your subscriptions as an OPML file.
Using JSON
Alternatively, you can define your feeds in a JSON file with the following format:
Running the MCP Server
There are two ways to run the MCP server:
Option 1: Running manually
1. Open a terminal or command prompt
2. Navigate to the project directory
3. Run the server directly:
Keep this terminal window open while using Claude Desktop. The server will run until you close the terminal.
Option 2: Auto-starting with Claude Desktop (recommended for regular use)
The Claude Desktop can automatically start the MCP server when needed. To set this up:
Configuration
The Claude Desktop configuration file is located at:
- **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
- **Linux**: ~/.config/Claude/claude_desktop_config.json
Edit this file to add the RSS Aggregator MCP configuration. If the file doesn't exist, create it:
**Important Notes**:
- Replace ABSOLUTE_PATH_TO_DIRECTORY with the **complete absolute path** where you installed the MCP
- macOS/Linux example: /Users/username/mcp-rss-aggregator
- Windows example: C:\\Users\\username\\mcp-rss-aggregator