feed-mcp

Website: richardwooding.github.io/feed-mcp

Bring RSS feeds to Claude Desktop — Read news, blogs, and updates directly in your AI conversations.

What is feed-mcp?

feed-mcp is a Model Context Protocol (MCP) server that lets Claude Desktop read RSS, Atom, and JSON feeds. Think of it as a bridge that connects your favorite websites' RSS feeds to Claude, so you can ask questions about the latest articles, get summaries, and stay updated—all from within your Claude chat.

Why use it?

- 📰 Stay informed — Read the latest news and blog posts without leaving Claude
- 🎯 Get summaries — Ask Claude to summarize multiple articles across different feeds
- 🔍 Deep dive — Research topics by querying specific feeds or articles
- ⚡ Save time — No need to open multiple websites to stay current

Quick Start

Step 1: Add to Claude Desktop

Open your Claude Desktop configuration file and add feed-mcp with your favorite feeds:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "feed-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "ghcr.io/richardwooding/feed-mcp:latest",
        "run",
        "https://techcrunch.com/feed/",
        "https://www.theverge.com/rss/index.xml"
      ]
    }
  }
}

Step 2: Restart Claude Desktop

Restart Claude Desktop to load the new configuration.

Step 3: Start chatting!

Try asking Claude:
- "What are the latest tech news headlines?"
- "Summarize the top 5 articles from my feeds"
- "Are there any articles about AI today?"

Popular Feed Collections

Technology News

{
  "mcpServers": {
    "tech-news": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "ghcr.io/richardwooding/feed-mcp:latest",
        "run",
        "https://techcrunch.com/feed/",
        "https://www.theverge.com/rss/index.xml",
        "https://www.wired.com/feed/rss",
        "https://feeds.arstechnica.com/arstechnica/index"
      ]
    }
  }
}

Security & Privacy

{
  "mcpServers": {
    "security-news": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "ghcr.io/richardwooding/feed-mcp:latest",
        "run",
        "https://krebsonsecurity.com/feed/",
        "https://www.schneier.com/blog/atom.xml",
        "https://www.bleepingcomputer.com/feed/"
      ]
    }
  }
}

Web Development

{
  "mcpServers": {
    "webdev-news": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "ghcr.io/richardwooding/feed-mcp:latest",
        "run",
        "https://css-tricks.com/feed/",
        "https://www.smashingmagazine.com/feed/",
        "https://hacks.mozilla.org/feed/"
      ]
    }
  }
}

Podcasts

{
  "mcpServers": {
    "podcasts": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "ghcr.io/richardwooding/feed-mcp:latest",
        "run",
        "https://feeds.npr.org/510282/podcast.xml",
        "https://feeds.npr.org/381444908/podcast.xml"
      ]
    }
  }
}

Try asking Claude:
- "What are the latest podcast episodes?"
- "Summarize the most recent episode from NPR Politics"
- "Are there any episodes about climate change this week?"

Using Your RSS Reader Feeds

Already have feeds in Feedly, Inoreader, or another RSS reader? Export them as OPML and use with feed-mcp:

{
  "mcpServers": {
    "my-feeds": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/path/to/your/feeds.opml:/feeds.opml:ro",
        "ghcr.io/richardwooding/feed-mcp:latest",
        "run", "--opml", "/feeds.opml"
      ]
    }
  }
}

How to export OPML:
- Feedly: Settings → OPML → Export
- Inoreader: Preferences → Folders and Tags → Export OPML
- NewsBlur: Account → Import/Export → Export Stories
- The Old Reader: Settings → Import/Export → Export

How Claude Reads Feeds

When you ask Claude about your feeds, here's what happens:

1. Browse first — Claude gets a list of article titles and metadata
2. Read selectively — Claude only fetches full content for articles you ask about
3. Smart caching — Articles are cached to avoid re-fetching

This two-pass approach keeps responses fast and prevents overwhelming your conversation.

Example Usage

You: "What's new in tech today?"

Claude will:
1. Browse your tech feed titles
2. Summarize the latest headlines
3. Ask if you want details on specific articles

You: "Tell me more about the first article"

Claude will:
1. Fetch the full content of that article
2. Provide a detailed summary or answer your questions

Features

- 🌐 Multiple formats — RSS, Atom, and JSON feeds
- 📱 Import from readers — OPML support for easy migration
- 💾 Smart caching — Efficient feed retrieval with automatic updates
- ⚡ Fast & reliable — Built-in rate limiting and error handling
- 🔒 Secure — URL validation and private IP blocking
- 🐳 Easy deployment — Docker and Podman support

Advanced Features

For power users, feed-mcp includes:

- Dynamic feed management — Add/remove feeds at runtime
- MCP Resources — Advanced filtering and real-time subscriptions
- Intelligent prompts — Analyze trends, monitor keywords, generate reports
- Circuit breakers — Automatic handling of failing feeds
- Custom configuration — Rate limiting, retries, connection pooling

See docs/ADVANCED.md for details.

Alternative Installation Methods

MCP Bundle (Claude Desktop, one-click)

Every release attaches MCP Bundles
(.mcpb) — one per platform. Download the bundle matching your OS and architecture (e.g.
feed-mcp_<version>_darwin_arm64.mcpb) and open it with Claude Desktop to install — no Docker
or Go toolchain required. The bundle's settings screen lets you set feed URLs, the per-feed
request timeout, and the cache expiration. Feeds are optional at install time: runtime feed
management is enabled, so you can also add feeds later with the add_feed tool.

Homebrew

brew install richardwooding/tap/feed-mcp

Then configure Claude Desktop:

{
  "mcpServers": {
    "feed-mcp": {
      "command": "feed-mcp",
      "args": ["run", "https://techcrunch.com/feed/"]
    }
  }
}

Go Install

If you have Go installed:

go install github.com/richardwooding/feed-mcp@latest
feed-mcp run https://techcrunch.com/feed/

Then configure Claude Desktop:

{
  "mcpServers": {
    "feed-mcp": {
      "command": "feed-mcp",
      "args": ["run", "https://techcrunch.com/feed/"]
    }
  }
}

Podman

Prefer Podman over Docker? Just replace docker with podman:

{
  "mcpServers": {
    "feed-mcp": {
      "command": "podman",
      "args": [
        "run", "-i", "--rm",
        "ghcr.io/richardwooding/feed-mcp:latest",
        "run",
        "https://techcrunch.com/feed/"
      ]
    }
  }
}

Transport Options

feed-mcp supports multiple transport protocols for different deployment scenarios:

| Transport | Description | Use Case |
|-----------|-------------|----------|
| stdio | Standard input/output (default) | Claude Desktop, local CLI |
| streamable-http | HTTP server with Streamable HTTP protocol | Web deployments, remote access |
| http-with-sse | Deprecated, maps to streamable-http | Backwards compatibility only |

stdio (Default)

Standard input/output transport for local usage. This is the default and what Claude Desktop uses:

feed-mcp run https://techcrunch.com/feed/

Streamable HTTP

HTTP-based transport for web deployments and remote access:

```bash