FreshRSS MCP Server
Provides comprehensive RSS feed management through FreshRSS, including article operations (list, read/unread, star/unstar), feed subscriptions, folder/label organization, and OPML import/export capabilities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FreshRSS MCP Server show my 10 most recent unread articles"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-serverUsage
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_articlesmark_as_readmark_as_unreadstar_articlesunstar_articlesmark_all_as_read
Feeds:
list_feedssubscribeunsubscribeedit_feedexport_opmlimport_opmlquickadd_feed
Folders & labels:
list_folderslist_labelsadd_labelsremove_labelsrename_folderrename_labeldelete_folderdelete_label
Stats:
get_statsget_user_info
Favicons & sync (Fever API):
list_faviconsget_feed_faviconlist_unread_article_idslist_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 buildLicense
MIT
Available Tools
27 toolsadd_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
Scored across 27 tools
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.
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.
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.
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
Related MCP Connectors
RSS & Atom feed manager with full-text search, AI curation, and remote MCP endpoint.
Read, search and organize the RSS feeds you follow in Feeder. Tool calls need Feeder Plus.
Track and browse RSS feeds with ease. Fetch the latest entries from any feed URL and extract full…
Managed cloud RSS and Atom feed reader with a remote Model Context Protocol (MCP) endpoint. Zero server setup required — enables AI agents like Claude to instantly subscribe to feeds, search full-text articles, extract readable content, and access curated AI editions ("Your Newspaper") over secure streamable HTTP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with RSS readers that support the FreshRSS API through natural language. Allows users to manage and query their RSS feeds and articles via LLM conversations.7MIT
- FlicenseNot gradedqualityDmaintenanceEnables interaction with FreshRSS RSS feed readers through the Google Reader compatible API. Supports feed management, article reading/searching, and marking articles as read or starred.-
- AlicenseAqualityDmaintenanceEnables 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.86 npm10MIT
- AlicenseAqualityDmaintenanceEnables interaction with a FreshRSS instance to manage RSS feeds, read and organize articles, and handle subscriptions through natural language.18MIT