Inoreader MCP Integration
An MCP (Model Context Protocol) server that integrates Inoreader with Claude Desktop, enabling intelligent RSS feed management and analysis.
Features
Feed and Article Management
- List feeds: View all your subscribed feeds
- List articles: Browse articles with filters (unread, by feed, by period)
- Read content: Access full content of specific articles
- Mark as read: Mark articles individually or in bulk
Search and Analysis
- Search articles: Search for keywords across your feeds
- Summarize articles: Generate summaries of individual articles
- Analyze multiple articles:
- Consolidated summaries
- Trend analysis
- Sentiment analysis
- Keyword extraction
- Statistics: View unread article counters
Installation
🚀 Auto-Installer (Recommended)
One command installs everything:
python3 install_inoreader_mcp.py
The auto-installer will:
- ✅ Install all Python dependencies
- ✅ Prompt for your Inoreader credentials
- ✅ Configure Claude Desktop automatically
- ✅ Leave everything ready to use!
Windows users: Double-click install.bat
📦 Drag & Drop Installation
Try dragging inoreader-mcp.dxt onto Claude Desktop (experimental - may not work on all versions)
🛠️ Manual Installation
- Clone the repository
git clone <repository-url>
cd inoreader_mcp
2. Install dependencies
pip install -r requirements.txt
3. Configure credentials
Copy the .env.example file to .env:
cp .env.example .env
Edit the .env file with your Inoreader credentials:
INOREADER_APP_ID=your_app_id
INOREADER_APP_KEY=your_app_key
INOREADER_USERNAME=your_email
INOREADER_PASSWORD=your_password
To obtain credentials:
- Visit https://www.inoreader.com/developers/
- Create a new application
- Copy the App ID and App Key
4. Configure in Claude Desktop
Add to Claude Desktop's configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"inoreader": {
"command": "python",
"args": ["/full/path/to/inoreader_mcp/main.py"],
"env": {
"INOREADER_APP_ID": "your_app_id",
"INOREADER_APP_KEY": "your_app_key",
"INOREADER_USERNAME": "your_email",
"INOREADER_PASSWORD": "your_password"
}
}
}
}
Usage
After configuration, restart Claude Desktop. Commands will be available in natural language:
Example commands
List feeds:
- "List my feeds"
- "What feeds do I follow?"
List articles:
- "Show the last 20 unread articles"
- "What unread articles do I have from TechCrunch?"
- "Show articles from the last 3 days"
Search:
- "Search articles about artificial intelligence"
- "Find Python articles from the last 7 days"
Read and mark:
- "Read article [ID]"
- "Mark all articles from feed X as read"
Analysis:
- "Summarize the top 5 AI articles this week"
- "Analyze trends in my feeds today"
- "What's the overall sentiment of economy articles?"
- "Extract keywords from unread articles"
Statistics:
- "How many unread articles do I have?"
- "Show my feed statistics"
Project Structure
inoreader_mcp/
├── main.py # Main MCP server
├── inoreader_client.py # Inoreader API client
├── tools.py # MCP tools implementation
├── config.py # Configuration and credentials
├── utils.py # Helper functions
├── requirements.txt # Python dependencies
├── .env.example # Configuration example
└── README.md # This file
Development
Testing locally
python main.py
Logs
Logs are written to console. For debugging, check Claude Desktop's console.
Limitations
- Maximum 50 articles per request
- 5-minute cache for feed list
- 10-second timeout for API requests
Troubleshooting
Authentication error:
- Verify credentials are correct
- Confirm App has necessary permissions in Inoreader
MCP doesn't appear in Claude:
- Check the full path in configuration file
- Restart Claude Desktop
- Confirm Python is in system PATH
Request timeouts:
- Inoreader API may be slow
- Try reducing the number of requested articles
Contributing
Contributions are welcome! Please:
- Fork the project
- Create a feature branch
- Commit your changes
- Push to the branch
- Open a Pull Request
License
MIT License - see LICENSE file for details.