Skip to main content
Glama
alysson-souza

FreshRSS MCP Server

by alysson-souza
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

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