NetNewsWire MCP Server

A read-only Model Context Protocol (MCP) server for NetNewsWire, the open-source RSS reader for Mac.

Gives AI assistants like Claude access to your NetNewsWire feeds, articles, and search index.

Tools

| Tool | Description | |------|-------------| | list_accounts | List available NNW accounts (OnMyMac, iCloud, etc.) | | list_feeds | List subscribed feeds (parsed from OPML) | | list_starred_articles | Starred articles with optional feed filter and limit | | list_recent_articles | Recent articles by arrival date | | get_article | Full article content (HTML/text, authors, dates) by ID | | search_articles | Full-text search using NNW's FTS4 index | | get_article_count | Total, starred, and unread counts |

All tools are read-only. Nothing is modified.

Requirements

• macOS 26+
• Swift 6.2+
• NetNewsWire (Mac App Store or direct download)

Build

swift build -c release

The binary will be at .build/release/netnewswire-mcp.

Configure

Add to your Claude Code MCP config (~/.claude/claude_desktop_config.json or similar):

{
  "mcpServers": {
    "netnewswire": {
      "command": "/path/to/netnewswire-mcp"
    }
  }
}

How it works

The server reads NetNewsWire's SQLite databases directly (read-only mode) from:

~/Library/Containers/com.ranchero.NetNewsWire-Evergreen/Data/Library/Application Support/NetNewsWire/Accounts/

It auto-discovers all accounts and their databases on startup. Feed lists are parsed from each account's Subscriptions.opml file. Full-text search uses NNW's built-in FTS4 search index.

Dependencies

• swift-sdk - MCP protocol implementation for Swift
• GRDB.swift - SQLite toolkit for Swift

Notes

• Only tested with Claude Code. It should work with any MCP client, but your mileage may vary.
• This depends on NetNewsWire's internal database schema, which is not a public API and could change between versions.
• Feed IDs are the XML URLs of the feeds, not UUIDs.
• Dates are Unix timestamps (seconds since 1970).

License

MIT