An integration that allows Claude Desktop to fetch and read content from your favorite RSS feeds using the Model Context Protocol (MCP). - 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
Add this skill
npx mdskills install imprvhub/mcp-rss-aggregatorComprehensive RSS feed aggregator with excellent documentation and practical examples
1# MCP RSS Aggregator2[](https://archestra.ai/mcp-catalog/imprvhub__mcp-rss-aggregator)3[](https://mseep.ai/app/51854dcf-6cb2-4bd0-a37f-5b87ba25d7c7)4[](https://smithery.ai/server/@imprvhub/mcp-rss-aggregator)56<table style="border-collapse: collapse; width: 100%; table-layout: fixed;">7<tr>8<td style="padding: 15px; vertical-align: middle; border: none; text-align: center;">9 <a href="https://mseep.ai/app/imprvhub-mcp-rss-aggregator">10 <img src="https://mseep.net/pr/imprvhub-mcp-rss-aggregator-badge.png" alt="MseeP.ai Security Assessment Badge" />11 </a>12</td>13<td style="width: 40%; padding: 15px; vertical-align: middle; border: none;">An integration that allows Claude Desktop to fetch and read content from your favorite RSS feeds using the Model Context Protocol (MCP).</td>14<td style="width: 60%; padding: 0; vertical-align: middle; border: none; min-width: 300px; text-align: center;"><a href="https://glama.ai/mcp/servers/@imprvhub/mcp-rss-aggregator">15 <img style="max-width: 100%; height: auto; min-width: 300px;" src="https://glama.ai/mcp/servers/@imprvhub/mcp-rss-aggregator/badge" alt="RSS Aggregator MCP server" />16</a></td>17</tr>18</table>1920## Features2122- Read articles from your favorite RSS feeds directly in Claude Desktop23- Support for OPML files to import your existing feed subscriptions24- Organize feeds by categories25- Get the latest articles across all your feeds26- Filter articles by feed source or category27- Well-formatted article presentation with titles, snippets, and links2829## Demo3031<p>32 <a href="https://youtu.be/9pvm078fHkQ">33 <img src="public/assets/preview.png" width="600" alt="Status Observer MCP Demo">34 </a>35</p>3637<details>38<summary> Timestamps </summary>3940Click on any timestamp to jump to that section of the video4142[00:00](https://youtu.be/9pvm078fHkQ&t=0s) - **Sample RSS Feed Demonstration**:43Using 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).4445[01:05](https://youtu.be/9pvm078fHkQ&t=65s) - **Configuration File Editing Process**:46Step-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.4748[01:15](https://youtu.be/9pvm078fHkQ&t=75s) - **Application Restart Procedure**:49Illustrating the necessary step of closing and reopening the Claude Desktop application to properly load and apply the modified OPML file configuration changes.5051[01:25](https://youtu.be/9pvm078fHkQ&t=85s) - **Custom RSS Feed Results**:52Demonstration 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.53</details>5455## Requirements5657- Node.js 16 or higher58- Claude Desktop59- Internet connection to access RSS feeds6061## Installation6263### Installing Manually641. Clone or download this repository:65```bash66git clone https://github.com/imprvhub/mcp-rss-aggregator67cd mcp-rss-aggregator68```69702. Install dependencies:71```bash72npm install73```74753. Build the project:76```bash77npm run build78```7980## Feed Configuration8182The RSS Aggregator supports both OPML and JSON formats for feed configuration.8384### Using OPML (Recommended)8586OPML (Outline Processor Markup Language) is a standard format used by most RSS readers to export and import feed subscriptions.8788A sample OPML file with popular feeds is included in the `public/sample-feeds.opml` file. You can:89901. Use this file as-is912. Edit it to add your own feeds923. Replace it with an export from your existing RSS reader9394Most RSS readers allow you to export your subscriptions as an OPML file.9596### Using JSON9798Alternatively, you can define your feeds in a JSON file with the following format:99100```json101[102 {103 "title": "Hacker News",104 "url": "https://news.ycombinator.com/rss",105 "htmlUrl": "https://news.ycombinator.com/",106 "category": "Tech News"107 },108 {109 "title": "TechCrunch",110 "url": "https://techcrunch.com/feed/",111 "htmlUrl": "https://techcrunch.com/",112 "category": "Tech News"113 }114]115```116117## Running the MCP Server118119There are two ways to run the MCP server:120121### Option 1: Running manually1221231. Open a terminal or command prompt1242. Navigate to the project directory1253. Run the server directly:126127```bash128node build/index.js129```130131Keep this terminal window open while using Claude Desktop. The server will run until you close the terminal.132133### Option 2: Auto-starting with Claude Desktop (recommended for regular use)134135The Claude Desktop can automatically start the MCP server when needed. To set this up:136137#### Configuration138139The Claude Desktop configuration file is located at:140141- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`142- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`143- **Linux**: `~/.config/Claude/claude_desktop_config.json`144145Edit this file to add the RSS Aggregator MCP configuration. If the file doesn't exist, create it:146147```json148{149 "mcpServers": {150 "rssAggregator": {151 "command": "node",152 "args": ["ABSOLUTE_PATH_TO_DIRECTORY/mcp-rss-aggregator/build/index.js"],153 "feedsPath": "ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml"154 }155 }156}157```158159**Important Notes**:160- Replace `ABSOLUTE_PATH_TO_DIRECTORY` with the **complete absolute path** where you installed the MCP161 - macOS/Linux example: `/Users/username/mcp-rss-aggregator`162 - Windows example: `C:\\Users\\username\\mcp-rss-aggregator`163- Replace `ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml` with the path to your OPML or JSON file164 - If omitted, the sample feeds file will be used165166If you already have other MCPs configured, simply add the "rssAggregator" section inside the "mcpServers" object:167168```json169{170 "mcpServers": {171 "otherMcp1": {172 "command": "...",173 "args": ["..."]174 },175 "rssAggregator": {176 "command": "node",177 "args": [178 "ABSOLUTE_PATH_TO_DIRECTORY/mcp-rss-aggregator/build/index.js"179 ],180 "feedsPath": "ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml"181 }182 }183}184```185186The MCP server will automatically start when Claude Desktop needs it, based on the configuration in your `claude_desktop_config.json` file.187188## Usage1891901. Restart Claude Desktop after modifying the configuration1912. In Claude, use the `rss` command to interact with the RSS Aggregator MCP Server1923. The MCP server runs as a subprocess managed by Claude Desktop193194## Available Commands195196The RSS Aggregator MCP provides a tool named `rss` with several commands:197198| Command | Description | Parameters | Example |199|---------|-------------|------------|---------|200| `latest` | Show latest articles from all feeds | Optional limit (--N) | `rss latest --20` |201| `top` or `best` | Show top articles from all feeds | Optional limit (--N) | `rss top --15` |202| `list` | List all available feeds | None | `rss list` |203| `--[feed-id]` | Show articles from a specific feed | Optional limit (--N) | `rss --hackernews --10` |204| `[category]` | Show articles from a specific category | Optional limit (--N) | `rss "Tech News" --20` |205| `set-feeds-path --[path]` | Set path to OPML/JSON file | Path to file | `rss set-feeds-path --/path/to/feeds.opml` |206207## Example Usage208209Here are various examples of how to use the RSS Aggregator with Claude:210211### Direct Commands:212213```214rss latest215rss top --20216rss list217rss "Tech News"218rss --hackernews219rss --techcrunch --15220```221222### Natural Language Queries:223224You can also interact with the MCP using natural language. Claude will interpret these requests and use the appropriate commands:225226- "What are the latest news on Hacker News?"227- "Show me the top tech articles today"228- "Fetch the latest articles from my programming feeds"229- "List all my RSS feeds"230231## Extended Usage Examples232233### Daily News Briefing234235Get your news briefing from all your sources:236237```238rss latest --25239```240241This will fetch the 25 most recent articles across all your feeds, giving you a quick overview of the latest news.242243### Exploring Top Content244245Find the most important or popular articles:246247```248rss top --20249```250251### Category-Based Reading252253Focus on specific content categories:254255```256rss "Tech News" --30257rss "Politics" --15258rss "Science" --10259```260261### Source-Specific Updates262263Read updates from specific sources you follow:264265```266rss --hackernews --20267rss --nytimes268rss --techcrunch --15269```270271### Discover Your Available Feeds272273Find out what feeds you have configured:274275```276rss list277```278279### Combining Multiple Requests280281You can make multiple sequential requests to build a comprehensive view:282283```284rss "Tech News" --10285rss "Finance" --10286rss top --5287```288289### Practical Workflows2902911. **Morning Routine**:292 ```293 rss top --10294 rss "News" --5295 ```2962972. **Industry Research**:298 ```299 rss "Industry News" --15300 rss --bloomberg --5301 ```3023033. **Tech Updates**:304 ```305 rss --hackernews --10306 rss --techcrunch --5307 ```308309### Working with Claude310311You can ask Claude to analyze or summarize the articles:3123131. After running: `rss latest --10`314 Ask: "Can you summarize these articles?"3153162. After running: `rss "Tech News" --15`317 Ask: "What are the key trends in these tech articles?"3183193. After running: `rss --nytimes --washingtonpost --10`320 Ask: "Compare how these sources cover current events"321322## Troubleshooting323324### "Server disconnected" error325If you see the error "MCP RSS Aggregator: Server disconnected" in Claude Desktop:3263271. **Verify the server is running**:328 - Open a terminal and manually run `node build/index.js` from the project directory329 - If the server starts successfully, use Claude while keeping this terminal open3303312. **Check your configuration**:332 - Ensure the absolute path in `claude_desktop_config.json` is correct for your system333 - Double-check that you've used double backslashes (`\\`) for Windows paths334 - Verify you're using the complete path from the root of your filesystem335336### Tools not appearing in Claude337If the RSS Aggregator tools don't appear in Claude:338- Make sure you've restarted Claude Desktop after configuration339- Check the Claude Desktop logs for any MCP communication errors340- Ensure the MCP server process is running (run it manually to confirm)341342### Feeds not loading343If your feeds aren't loading properly:344- Make sure your OPML/JSON file is correctly formatted345- Check if the `feedsPath` in your configuration is correct346- Try running the server manually with a known good feeds file347348## Contributing349350Contributions to improve the RSS Aggregator are welcome! Here are some ways you can contribute:3513521. Add support for more feed formats3532. Improve feed parsing and error handling3543. Add more visualization options for articles3554. Improve categorization and filtering capabilities356357## License358359This project is licensed under the Mozilla Public License 2.0 - see the [LICENSE](https://github.com/imprvhub/mcp-rss-aggregator/blob/main/LICENSE) file for details.360361## Related Links362363- [Model Context Protocol](https://modelcontextprotocol.io/)364- [Claude Desktop](https://claude.ai/download)365- [MCP Series](https://github.com/mcp-series)366
Full transparency — inspect the skill content before installing.