freshrss-mcpYour feed reader, spoken to

An MCP server for FreshRSS: list feeds, read and triage articles, manage subscriptions and categories — from Claude, Codex or any MCP client.

Get started

Tools reference

GitHub

Sixteen tools, no stream ids
The Google Reader API speaks in stream identifiers and hexadecimal item tags. These tools take numeric feed ids, category and label names, ISO dates and decimal article ids, and hand back plain text instead of raw HTML.
Runs anywhere stdio does
A single npx command, a Claude Desktop JSON block, a Codex TOML entry, or a multi-arch container image with an SBOM and build provenance.
Built for untrusted feeds
Every article was written by a stranger on the internet, so responses are marked as data, destructive tools need a server-issued token, feed URLs are stripped of credentials, and article text is capped per article and per response.

The server holds no state beyond cached auth tokens and short-lived confirmation tokens; FreshRSS remains the source of truth, and it is what polls the feeds.

See it run

Demo: listing the tools, the subscribed feeds and the newest article through the MCP Inspector CLI

freshrss-mcpYour feed reader, spoken to

Sixteen tools, no stream ids

Runs anywhere stdio does

Built for untrusted feeds

See it run ​

See it run