FreshRSS MCP Server
Provides tools for interacting with FreshRSS via its Google Reader compatible API, enabling management of RSS feed subscriptions, reading and searching articles, marking articles as read or starred, and managing categories with unread counts.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
FreshRSS MCP Server
A Model Context Protocol (MCP) server for interacting with FreshRSS via its Google Reader compatible API. This server provides tools for browsing feeds, reading articles, and managing subscriptions. Authentication is handled during server startup.
Features
User Information
get_user_info()- Get authenticated user information
Feed Management
list_subscriptions()- List all RSS feed subscriptionsadd_subscription()- Add new RSS feed subscriptionlist_categories()- List all categories/tags with unread counts
Article Reading
get_articles()- Get articles from feeds, categories, or reading listsearch_articles()- Search articles by keywordsget_starred_articles()- Get all starred articlesget_unread_counts()- Get unread article counts by feed/category
Article Management
mark_article_read()- Mark specific article as readmark_article_starred()- Star/unstar articlesmark_all_as_read()- Mark all articles in a stream as read
Related MCP server: FreshRSS MCP Server
Installation
Install dependencies:
pip install -r requirements.txtRun the MCP server with your FreshRSS credentials:
# Using command line arguments
python freshrss_mcp_server.py --url https://your-freshrss-server.com --email your-email@example.com --password your-password
# Or using environment variables
export FRESHRSS_EMAIL="your-email@example.com"
export FRESHRSS_PASSWORD="your-password"
python freshrss_mcp_server.py --url https://your-freshrss-server.comUsage
Once the server is running and authenticated, you can use the available tools:
Basic Operations
# List subscriptions
subscriptions = await list_subscriptions()
# Get recent articles
articles = await get_articles(count=10)
# Search for articles
results = await search_articles("python", count=5)
# Mark article as read
await mark_article_read("article-id-here")
# Get unread counts
unread = await get_unread_counts()Stream IDs
Common stream IDs for getting articles:
user/-/state/com.google/reading-list- All articlesuser/-/state/com.google/starred- Starred articlesuser/-/state/com.google/read- Read articlesfeed/[feed-url]- Specific feeduser/-/label/[category]- Specific category
Command Line Options
--url(required): FreshRSS server URL--email: Email address for authentication (can also use FRESHRSS_EMAIL env var)--password: Password for authentication (can also use FRESHRSS_PASSWORD env var)
API Compatibility
This server implements the Google Reader API endpoints that FreshRSS supports:
Authentication (
/accounts/ClientLogin) - handled at startupUser info (
/reader/api/0/user-info)Subscriptions (
/reader/api/0/subscription/list,/reader/api/0/subscription/quickadd)Articles (
/reader/api/0/stream/contents/)Tagging (
/reader/api/0/edit-tag)Unread counts (
/reader/api/0/unread-count)Categories (
/reader/api/0/tag/list)
Requirements
Python 3.7+
FastMCP library
aiohttp for async HTTP requests
FreshRSS server with API access enabled
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
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…
Read RSS, Atom and JSON feeds, or find the feed of any website, with filters and only-new mode
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
- AlicenseBqualityDmaintenanceEnables interaction with FreshRSS instances through the Google Reader API. Supports managing articles, feeds, folders, labels, and OPML import/export for RSS feed aggregation through natural language.2727 npm2MIT
- 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.810 npm10MIT
- AlicenseAqualityDmaintenanceEnables interaction with a FreshRSS instance to manage RSS feeds, read and organize articles, and handle subscriptions through natural language.18MIT