JN

jellllly420/netnewswire-mcp

Developer tools
68 stars 0 forks Качество 55 Тренд 55

An MCP server that connects Claude to NetNewsWire via AppleScript on macOS. Browse feeds, fetch and search articles, mark as read/starred, and subscribe to new feeds.

Обзор

An MCP server that connects Claude to NetNewsWire via AppleScript on macOS. Browse feeds, fetch and search articles, mark as read/starred, and subscribe to new feeds.

README

NetNewsWire MCP Server

An MCP server that connects Claude to NetNewsWire via AppleScript on macOS. Browse feeds, fetch and search articles, mark as read/starred, and subscribe to new feeds.

Requirements

  • macOS (uses AppleScript to communicate with NetNewsWire)
  • NetNewsWire must be running
  • Node.js >= 18.0.0

Installation

Option 1: MCP Bundle (.mcpb)

Download the .mcpb file from Releases and double-click to install in Claude Desktop.

Option 2: Build from Source

git clone https://github.com/jellllly420/netnewswire-mcp.git
cd netnewswire-mcp
npm install
npm run build

Then add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "netnewswire": {
      "command": "node",
      "args": ["/path/to/netnewswire-mcp/dist/index.js"]
    }
  }
}

Option 3: npx

{
  "mcpServers": {
    "netnewswire": {
      "command": "npx",
      "args": ["@jellllly/netnewswire-mcp"]
    }
  }
}

Tools

Tool Description
list_feeds List all subscribed feeds and folders, optionally filtered by account
get_articles Fetch articles with filters: unread, starred, by feed/folder, with limit
read_article Get full article content (HTML, text, metadata) by article ID
mark_articles Mark articles as read/unread/starred/unstarred (batch support)
subscribe Subscribe to a new RSS/Atom feed by URL
search_articles Search articles by keyword across all feeds

Example Workflow

Daily morning summary:

“Get all my unread articles from the last day and give me a summary of the most interesting ones. Star the ones I should read in full, and mark the rest as read.”

Topic research:

“Search my feeds for articles about ‘AI agents’ and summarize what’s been published recently.”

Feed management:

“Subscribe to https://example.com/feed.xml in my Tech folder.”

Development

npm run dev    # Watch mode — recompiles on changes
npm run build  # Production build
npm start      # Run the server

License

MIT

View this README on GitHub

Установка

npx @jellllly/netnewswire-mcp

Конфигурация

{ "mcpServers": { "netnewswire": { "command": "node", "args": ["/path/to/netnewswire-mcp/dist/index.js"] } } }