# Inoreader MCP MCP

> Inoreader lets you connect your entire news consumption stack—hundreds of RSS feeds and blogs—to any AI agent. It fetches article content, manages tags, tracks unread counts across all sources, and keeps your knowledge base organized through natural language commands.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** rss-reader, content-curation, news-monitoring, feed-filtering, content-extraction

## Description

You're constantly reading stuff—research papers, industry blogs, social media threads. Manually checking those streams is a time sink. This MCP gives your AI client access to hundreds of feeds. You can use it to list all your subscriptions and quickly add new content sources by URL. Beyond just pulling data, you control the structure: rename tags, delete folders, or apply organization labels using `edit_tag`. Need to know what's fresh? Get real-time summaries of unread counts across every category via `get_unread_counts`. The whole thing works through your AI client connected via Vinkius. You don't just read articles; you build an information architecture and keep track of everything important, making sure nothing falls through the cracks.

## Tools

### delete_tag
Removes a tag or folder from articles; the article content remains untouched.

### edit_tag
Adds, removes, or changes tags on specific articles for better categorization.

### get_unread_counts
Retrieves the total number of unread items found within a specific feed or folder.

### get_user_info
Pulls basic account information associated with your Inoreader profile.

### list_stream_contents
Retrieves the full article data for a chosen feed, folder, or tag stream.

### list_subscriptions
Lists all external feeds that are currently subscribed to your account.

### list_tags
Shows every existing user-created tag and folder in your information system.

### mark_all_as_read
Changes the read status of every article within a selected stream to marked as read.

### quick_add_subscription
Adds a brand new RSS or Atom feed by inputting its specific URL.

### rename_tag
Changes the name of an existing tag or folder to something more descriptive.

## Prompt Examples

**Prompt:** 
```
What are the latest news from my Tech folder?
```

**Response:** 
```
I've fetched the contents of your 'Tech' folder. Here are the top 3 stories: 'New AI Breakthrough' from TechCrunch, 'React 19 Released' from Dev.to, and 'The Future of Web3' from Wired. Would you like me to summarize any of these?
```

**Prompt:** 
```
Find articles about 'SpaceX' that I haven't read yet.
```

**Response:** 
```
Searching your unread reading list... I found 2 articles related to SpaceX: 'Starship Test Flight Update' and 'Falcon 9 Launch Schedule'. Both are marked as unread. Shall I open the description for the Starship flight?
```

**Prompt:** 
```
Mark all articles in my 'Social Media' tag as read.
```

**Response:** 
```
Processing batch update... Done! All articles within the 'Social Media' tag have been marked as read. Your unread count for this tag is now zero.
```

## Capabilities

### Managing Subscriptions
List all current feeds or subscribe to a new source using just a URL.

### Content Retrieval
Fetch specific articles from any designated feed, folder, or tag for processing.

### Information Organization
Group, rename, or delete tags and folders to maintain a clean information structure.

### Status Tracking
Check exactly how many items you haven't read across your entire collection of sources.

### Batch Actions
Mark all articles in an entire stream as read instantly, or get basic user profile data.

## Use Cases

### A competitor launch needs tracking.
The agent runs a query to pull articles about 'AI Chips' from three different industry feeds using `list_stream_contents`. The user then uses the AI to summarize key takeaways and applies the tag 'Competitor Alert' via `edit_tag`.

### A massive backlog of old news needs clearing.
The user identifies a folder containing articles from an expired project. Instead of opening each one, they instruct the agent to run `mark_all_as_read`, instantly clearing the entire stream's unread count.

### Need to consolidate sources.
A new niche topic emerges. The user finds three relevant blogs and uses `quick_add_subscription` for each, immediately integrating them into their reading list without changing any settings.

### Cleaning up an old knowledge vault.
The project is finished. Instead of manually deleting articles, the user runs `delete_tag` on the 'Old Project' tag across all streams to remove the organizational label while keeping the content for future reference.

## Benefits

- Stop manually checking feeds. Instead, use the `list_stream_contents` tool to have your agent pull content from dozens of sites in one go.
- Never lose an idea again. You can categorize articles instantly by running `edit_tag` and sorting them into structured folders like 'Inspiration' or 'To Read Later'.
- Know what matters right now. Running `get_unread_counts` gives you a single dashboard view of your unread workload, so you prioritize correctly.
- Build your knowledge base efficiently. If a critical source goes down, you can quickly add a replacement feed using the `quick_add_subscription` tool.
- Maintain data hygiene by listing all organizational labels with `list_tags`, then cleaning up stale folders or renaming them via `rename_tag`.

## How It Works

The bottom line is you get natural language control over your entire news archive, letting your agent manage it for you.

1. Subscribe to this MCP and provide your Inoreader Access Token.
2. Your AI client authenticates with the platform and pulls a list of available feeds and folders.
3. You query the tool to list content, apply tags (e.g., 'Tech'), or check unread counts.

## Frequently Asked Questions

**How do I use `quick_add_subscription` with Inoreader?**
You provide the tool with a valid RSS or Atom feed URL. The MCP then handles adding that new source to your personal reading list, making it immediately available for content retrieval.

**Can `list_stream_contents` fetch articles from different sources?**
Yes. You can specify a single feed, but you can also use tags or folders as criteria to pull related article contents across multiple subscriptions into one stream for review.

**What is the difference between `edit_tag` and `delete_tag`?**
`edit_tag` adds or removes labels from articles, keeping them accessible. `delete_tag` actually deletes the organizational label itself, which doesn't affect the article content.

**Does `mark_all_as_read` work across all my feeds?**
No. You must specify the stream or tag you want to clear. It works on a targeted level—you tell it which group of articles needs marking.

**How do I check my Inoreader account status using the `get_user_info` tool?**
It returns basic metadata about your connected account, confirming that the access token is valid and active. If you encounter specific authorization or expired token errors, it means the connection needs refreshing; the token itself must be updated in your developer preferences.

**If I use the `rename_tag` tool, how does it handle existing tag names or conflicting folder paths?**
The tool validates potential conflicts before making changes. If you try to rename a tag to a name that already exists, it will fail with an error code, preventing any data corruption. Always run `list_tags` first to check for available names.

**When calling `list_stream_contents`, what parameters can I pass to filter for specific content formats, like images or videos?**
You can specify filters beyond just text search. The tool accepts MIME type parameters and source IDs, allowing you to restrict results specifically to articles, images, or other media types within a given feed.

**Can `get_unread_counts` provide a comprehensive summary of all my active feeds and folders' unread totals?**
Yes, by default, it aggregates the unread counts across every accessible stream in your account. If you need to limit the count to only a specific set of feeds, pass those feed IDs as an optional scope parameter.

**Can I use this to find specific articles across all my subscriptions?**
Yes! Use the `list_stream_contents` tool with the system stream ID `user/-/state/com.google/reading-list`. You can then ask the AI to filter or search for specific keywords within the returned articles.

**Is it possible to star articles directly from the conversation?**
Absolutely. Use the `edit_tag` tool and provide the Article ID with the add parameter set to `user/-/state/com.google/starred`. This will instantly save the article to your Starred folder in Inoreader.

**How do I see how many unread articles I have in each folder?**
Run the `get_unread_counts` tool. It returns a structured list of all your streams (feeds, folders, and tags) along with the precise count of unread items for each.