FreshRSS MCP Server: Install & Setup

Install FreshRSS in Claude Code

npm

Claude Code

claude mcp add freshrss -e FRESHRSS_URL=... -e FRESHRSS_USER=... -e FRESHRSS_API_PASSWORD=... -- npx -y @ni-c/freshrss-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "freshrss": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/freshrss-mcp"
      ],
      "env": {
        "FRESHRSS_URL": "...",
        "FRESHRSS_USER": "...",
        "FRESHRSS_API_PASSWORD": "..."
      }
    }
  }
}

Docker

Claude Code

claude mcp add freshrss -e FRESHRSS_URL=... -e FRESHRSS_USER=... -e FRESHRSS_API_PASSWORD=... -- docker run -i --rm -e FRESHRSS_URL -e FRESHRSS_USER -e FRESHRSS_API_PASSWORD ghcr.io/ni-c/freshrss-mcp:0.3.2

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "freshrss": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "FRESHRSS_URL",
        "-e",
        "FRESHRSS_USER",
        "-e",
        "FRESHRSS_API_PASSWORD",
        "ghcr.io/ni-c/freshrss-mcp:0.3.2"
      ],
      "env": {
        "FRESHRSS_URL": "...",
        "FRESHRSS_USER": "...",
        "FRESHRSS_API_PASSWORD": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the FreshRSS MCP server do?

Read and manage a self-hosted FreshRSS instance: feeds, categories, labels, articles, read and star state, and OPML import and export.

Is the FreshRSS MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does FreshRSS run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add FreshRSS to Claude Code?

Run: claude mcp add freshrss -e FRESHRSS_URL=... -e FRESHRSS_USER=... -e FRESHRSS_API_PASSWORD=... -- npx -y @ni-c/freshrss-mcp

More search & web scraping MCP servers

View all

Unsplash

hanoak/unsplash-mcp-server

Unsplash API: photos, search, users, collections, topics and stats, with guideline-compliant attribution, download tracking and rate-limit reporting.

LocalAccount neededTypeScript

ComparEdge

comparedge/mcp-server-comparedge

Plans, prices, hidden costs, alternatives and comparisons for SaaS, AI and LLM tools.

LocalAccount neededTypeScript

Alexandria

The-40-Thieves/alexandria-mcp

Search, read, and cite across 152 libraries: 11 tools, 3 prompts, and a full-text resource.

LocalFree

Page Capture

chasesaurabh/mcp-page-capture

Capture webpage screenshots, viewport or full-page, as base64 PNG.

LocalFreeTypeScript

Casemgr

0100

mstang/casemgr-mcp

Shared workspace your AI agent writes to. 184 tools, persistent memory, semantic search.

LocalAccount needed

Feedbagel

Prototypr/feedbagel-mcp

Search the Feedbagel RSS catalog, follow feeds and route new entries to webhooks.

LocalAccount neededTypeScript