inoreader-mcp

MCP server for the Inoreader RSS reader API. Lets Claude help you triage articles, analyze feed health, and manage subscriptions.

Setup

1. Create an Inoreader API application

Go to the Inoreader Developer Portal and create a new application.

• Set the redirect URI to http://localhost:3333/callback
• Note your Client ID and Client Secret

2. Add to Claude Code

claude mcp add -s user \
  -e INOREADER_CLIENT_ID=your-client-id \
  -e INOREADER_CLIENT_SECRET=your-client-secret \
  inoreader -- npx inoreader-mcp

Or for Claude Desktop, add to your config file:

{
  "mcpServers": {
    "inoreader": {
      "command": "npx",
      "args": ["inoreader-mcp"],
      "env": {
        "INOREADER_CLIENT_ID": "your-client-id",
        "INOREADER_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

3. Authenticate

On first use, ask Claude to call the setup_auth tool. It will give you an OAuth URL to open in your browser. After authorizing, copy the code parameter from the redirect URL and pass it back. Tokens are saved to ~/.config/inoreader-mcp/tokens.json and refresh automatically.

Tools

Reading

Tool	Description	API Cost
get_unread_counts	Unread counts for all feeds/folders, sorted by count	1 Z1
get_articles	Fetch articles with filters (stream, status, date range, pagination)	1 Z1/page
get_article_ids	Lightweight ID-only fetch for counting/batch ops	1 Z1

Subscriptions

Tool	Description	API Cost
list_subscriptions	All feeds with folders, URLs, metadata	1 Z1
manage_subscription	Subscribe, edit (rename/move), or unsubscribe	1 Z2

Organization

Tool	Description	API Cost
manage_tags	Mark read/unread/starred, apply/remove tags (batch support)	1 Z2
mark_all_read	Mark all items in a feed/folder as read	1 Z2
list_folders_and_tags	All folders and tags with unread counts	1 Z1

Analytics

Tool	Description	API Cost
analyze_feeds	Feed health analysis -- flags high-noise and dormant feeds	2 Z1
get_rate_limit_status	Check remaining API budget (uses cached headers)	0
get_user_info	Authenticated user info	1 Z1

Z1 = Zone 1 (read), Z2 = Zone 2 (write). Inoreader enforces ~100 requests/day per zone.

Rate Limits

Every tool description includes its API cost so Claude can budget calls. The get_rate_limit_status tool returns current usage without making any API requests. Inoreader's free tier allows ~100 requests per day per zone.

License

MIT