📰 Inoreader MCP Server

A TypeScript implementation of an MCP (Model Context Protocol) server that provides AI assistants with access to Inoreader RSS feeds and articles.

Features

• 8 MCP Tools for comprehensive RSS feed management
• Full TypeScript with complete type safety
• Smart Caching to optimize API usage
• Bulk Operations for efficient article management
• Error Handling with graceful fallbacks
• Claude Desktop Ready with easy configuration

Installation

npm install -g inoreader-mcp

Quick Start

1. Get Inoreader API Credentials

1. Go to Inoreader Developer Console
2. Create a new application
3. Note your App ID and App Key

2. Configure Environment

Set these environment variables:

INOREADER_APP_ID=your_app_id
INOREADER_APP_KEY=your_app_key
[email protected]
INOREADER_PASSWORD=your_password

3. Add to Claude Desktop

Edit your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "inoreader": {
      "command": "npx",
      "args": ["inoreader-mcp"],
      "env": {
        "INOREADER_APP_ID": "your_app_id",
        "INOREADER_APP_KEY": "your_app_key",
        "INOREADER_USERNAME": "your_email",
        "INOREADER_PASSWORD": "your_password"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | inoreader_list_feeds | List all RSS feeds with unread counts | | inoreader_list_articles | List articles with filters (unread, by feed, date range) | | inoreader_search | Search articles by keyword | | inoreader_get_content | Get full article content | | inoreader_mark_as_read | Mark articles as read (single or bulk) | | inoreader_summarize | Generate article summaries | | inoreader_analyze | Analyze articles for trends and insights | | inoreader_stats | Get feed statistics |

Usage Examples

Ask Claude:

• "Show me my unread articles from today"
• "Search for articles about artificial intelligence"
• "Summarize the top 5 articles from TechCrunch"
• "Mark all articles older than a week as read"
• "What are the trending topics in my feeds?"

Development

Build from Source

# Download the source code
cd inoreader-mcp
npm install
npm run build

Run Tests

npm test
npm run test:coverage

Project Structure

src/
├── index.ts          # Entry point
├── server.ts         # MCP server implementation
├── inoreader-api.ts  # Inoreader API client
├── auth.ts           # Authentication handling
├── types.ts          # TypeScript definitions
└── tools/            # MCP tool implementations

Troubleshooting

Authentication Failed

• Verify credentials in Inoreader web interface
• Check that username is your full email
• Ensure API access is enabled for your account

Environment Variables Not Loading

• Restart Claude Desktop after config changes
• Check JSON syntax in config file
• Try setting variables in .env file

Network Issues

• Check internet connection
• Verify Inoreader API is accessible
• Check firewall settings

License

MIT License - See LICENSE file

Support

• Inoreader API Docs
• MCP Documentation

Built with ❤️ by Dindi Coelho