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: MCP RSS

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

Install Server
A
license - permissive license
B
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
4Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    Enables intelligent RSS feed management with AI-powered semantic search, advanced filtering, and a comprehensive reading workflow. Supports OPML parsing, article organization with status tracking, and token-efficient browsing of large feed collections.
    Last updated
    39
    5
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Enables AI assistants to interact with FreshRSS feeds via the Fever API, allowing listing feeds, fetching unread items, marking items as read/unread, and managing feed subscriptions.
    Last updated
    2
    8
    MIT

View all related MCP servers

Related MCP Connectors

  • Track and browse RSS feeds with ease. Fetch the latest entries from any feed URL and extract full…

  • Browse and manage Reddit posts, comments, and threads. Fetch user activity, explore hot/new/rising…

  • rss2json: convert any RSS/Atom feed to JSON. Keyless basic, optional API key for count.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/alysson-souza/freshrss-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server