Inoreader MCP Server

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

1. 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.