Skip to main content
Glama

FreshRSS MCP Server

Model Context Protocol (MCP) server for interacting with a FreshRSS instance.

Features

  • Articles: list, filter, read/unread, star/unstar, mark‑all‑read

  • Feeds: list, subscribe, unsubscribe, rename, move between folders

  • Folders & labels: list, create via tagging, rename, delete

  • OPML: export/import subscriptions

  • Quick‑add: add a site URL and let FreshRSS discover the feed

  • Fever helpers: favicons, unread/starred ID lists

Related MCP server: FreshRSS MCP Server

Requirements

  • Node.js 18+

  • FreshRSS with Google Reader API enabled

  • FreshRSS API password (Settings → Profile → API Management)

Installation

npm install -g @equaldepth/freshrss-mcp-server

Usage

Claude Desktop

{
  "mcpServers": {
    "freshrss": {
      "command": "npx",
      "args": ["@equaldepth/freshrss-mcp-server"],
      "env": {
        "FRESHRSS_URL": "https://your-freshrss-instance.com",
        "FRESHRSS_USERNAME": "your-username",
        "FRESHRSS_API_PASSWORD": "your-api-password"
      }
    }
  }
}

GitHub Copilot

{
  "servers": {
    "freshrss": {
      "command": "npx",
      "args": ["@equaldepth/freshrss-mcp-server"],
      "env": {
        "FRESHRSS_URL": "https://your-freshrss-instance.com",
        "FRESHRSS_USERNAME": "your-username",
        "FRESHRSS_API_PASSWORD": "your-api-password"
      }
    },
  }
}

Tools

Articles:

  • list_articles

  • mark_as_read

  • mark_as_unread

  • star_articles

  • unstar_articles

  • mark_all_as_read

Feeds:

  • list_feeds

  • subscribe

  • unsubscribe

  • edit_feed

  • export_opml

  • import_opml

  • quickadd_feed

Folders & labels:

  • list_folders

  • list_labels

  • add_labels

  • remove_labels

  • rename_folder

  • rename_label

  • delete_folder

  • delete_label

Stats:

  • get_stats

  • get_user_info

Favicons & sync (Fever API):

  • list_favicons

  • get_feed_favicon

  • list_unread_article_ids

  • list_starred_article_ids

Examples

{ "name": "list_articles", "arguments": { "filter": "unread", "order": "newest", "count": 10 } }
{ "name": "list_articles", "arguments": { "state": "starred", "count": 5 } }
{ "name": "subscribe", "arguments": { "url": "https://example.com/feed.xml", "title": "Example", "category": "Tech" } }
{ "name": "edit_feed", "arguments": { "feedId": "1", "category": "Tech" } }
{ "name": "export_opml", "arguments": {} }

Tool inputs are strictly validated; unknown fields error.

Development

npm run dev
npm run lint
npm run typecheck
npm run format
npm run build

License

MIT

Available Tools

27 tools
add_labelsC

Add labels to articles

Inputs: articleIds (required), labels (required).

delete_folderA

Delete a folder/category (feeds will be moved to default)

Inputs: name (required).

delete_labelC

Delete a label

Inputs: name (required).

edit_feedA

Edit a feed subscription (rename or move to different category)

Inputs: feedId (required), title, category.

export_opmlB

Export all subscriptions as OPML

Inputs: no named parameters.

get_feed_faviconB

Get a feed favicon as an MCP resource (Fever API)

Inputs: feedId (required).

get_statsC

Get unread counts and statistics

Inputs: no named parameters.

get_user_infoB

Get current user information

Inputs: no named parameters.

import_opmlC

Import subscriptions from OPML

Inputs: opml (required).

list_articlesC

List articles from FreshRSS with optional filtering

Inputs: count, filter, starred, state, +6 more.

list_faviconsB

List favicons for subscribed feeds (Fever API)

Inputs: no named parameters.

list_feedsB

List all subscribed RSS feeds

Inputs: no named parameters.

list_foldersB

List all folders/categories

Inputs: no named parameters.

list_labelsC

List all labels/tags

Inputs: no named parameters.

list_starred_article_idsA

List starred/saved article IDs (Fever API)

Inputs: no named parameters.

list_unread_article_idsB

List unread article IDs (Fever API)

Inputs: no named parameters.

mark_all_as_readB

Mark all articles in a stream as read

Inputs: streamId (required), olderThan.

mark_as_readB

Mark one or more articles as read

Inputs: articleIds (required).

mark_as_unreadB

Mark one or more articles as unread

Inputs: articleIds (required).

quickadd_feedB

Quick-add a feed URL; FreshRSS will detect the actual feed.

Inputs: url (required).

remove_labelsC

Remove labels from articles

Inputs: articleIds (required), labels (required).

rename_folderC

Rename a folder/category

Inputs: oldName (required), newName (required).

rename_labelC

Rename a label

Inputs: oldName (required), newName (required).

star_articlesC

Star/favorite one or more articles

Inputs: articleIds (required).

subscribeC

Subscribe to a new RSS feed

Inputs: url (required), title, category.

unstar_articlesB

Remove star from one or more articles

Inputs: articleIds (required).

unsubscribeC

Unsubscribe from an RSS feed

Inputs: feedId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 27 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific resources and actions in the FreshRSS domain. For example, list_articles vs. mark_as_read vs. subscribe are unambiguous, and even similar tools like add_labels and remove_labels are clearly differentiated by their opposing actions.

    Naming Consistency5/5

    All tools follow a consistent verb_noun naming pattern throughout, such as list_articles, edit_feed, delete_folder, and mark_as_read. There are no deviations in style or convention, making the tool set highly predictable and readable.

    Tool Count3/5

    With 27 tools, the count is on the high side for an RSS server, bordering on heavy. While it covers many operations, it may feel overwhelming compared to a more streamlined set of 3-15 tools, though it is not extreme like 50+ tools.

    Completeness5/5

    The tool set provides comprehensive CRUD and lifecycle coverage for RSS feed management, including subscription handling, article reading/starring, labeling, folder management, and import/export. No obvious gaps exist; agents can perform all core workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers