freshrss

name	freshrss
description	Lab's Freshrss integration — Self-hosted RSS feed aggregator. Use when the user wants to manage their Freshrss instance, or invokes `lab freshrss` / `mcp__lab__freshrss`. Calls the MCP tool first, falls back to the CLI if MCP is unavailable.

Freshrss

Self-hosted rss feed aggregator. Exposes 4 actions via the lab homelab control plane.

How to call it

Prefer the MCP tool. Fall back to the CLI only when MCP is unavailable.

MCP (preferred)

One tool: mcp__lab__freshrss. Dispatch shape: { "action": "<name>", "params": {...} }.

Discover actions live:

{ "action": "help" }
{ "action": "schema", "params": { "action": "<name>" } }

Full action catalog: references/mcp.md.

CLI fallback

lab freshrss --help
lab freshrss <action> --help
labby --json freshrss <action> ...

CLI mirrors MCP actions; dots become dashes (server.health → server-health). Full CLI surface: references/cli.md.

Highlights

• subscription.list — List all RSS feed subscriptions
• tag.list — List all tags/categories
• unread.counts — Get unread article counts per feed
• stream.items — Fetch articles from a feed or tag stream

Configuration

Credentials and base URLs live in ~/.lab/.env. Onboard / re-extract with labby extract scan and labby extract apply. Verify connectivity:

labby doctor service freshrss

When NOT to use this skill

• The user is asking about a different lab service — load that service's skill instead.
• The user is asking about lab itself (CLI internals, install, gateway, doctor across all services) — that's operator-tier, not freshrss-specific.