inoreader-mcp
An MCP server for the Inoreader RSS reader API that allows users to triage articles, analyze feed health, and manage subscriptions. It enables reading content, organizing folders, and performing batch tagging or status updates through natural language.
README
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.