inoreader-mcp

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.

Category
Visit Server

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

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.

Official
Featured
TypeScript
Audiense Insights MCP Server

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.

Official
Featured
Local
TypeScript
Magic Component Platform (MCP)

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.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
Kagi MCP Server

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.

Official
Featured
Python
graphlit-mcp-server

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.

Official
Featured
TypeScript
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

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.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured