MCP Server & CLI

Premium Archive

MCP Server & CLI

Connect AI agents to your NewsBlur account. Read feeds, triage stories, train classifiers, and manage subscriptions from Claude Code, Codex, or any MCP-compatible tool.

What your agent can do

Read your feeds — Get unread stories from any feed or folder, list all your folders and feeds, search across all subscriptions, retrieve saved stories by tag
Daily briefing — Get an AI-curated briefing with top stories, infrequent site gems, long reads, and stories matching your classifiers
Take action — Mark stories as read, save stories with tags and notes, subscribe to new feeds, share stories to your blurblog
Train intelligence — View and update classifiers to like or dislike authors, tags, titles, and feeds
Discover — Find new feeds by topic, see trending feeds, find feeds similar to ones you follow
Use prompt templates — Pre-built workflows for inbox triage, topic research, and feed health audits

22 tools available

Reading

newsblur_list_feeds All feeds with folders and unread counts
newsblur_get_stories Load stories from feeds, folders, or all
newsblur_get_saved_stories Saved stories by tag
newsblur_search_stories Full-text search
newsblur_get_original_text Full article from source
newsblur_get_feed_info Feed metadata and stats
newsblur_get_account_info Account and tier info
newsblur_get_daily_briefing AI-curated daily briefing with sections
newsblur_get_infrequent_stories Stories from rarely-publishing feeds
newsblur_list_folders Folder tree with unread counts
newsblur_list_folders_with_feeds Complete folder-feed hierarchy

Actions

newsblur_mark_stories_read Mark read by hash, feed, or folder
newsblur_save_story Save with tags, notes, highlights
newsblur_unsave_story Remove from saved
newsblur_subscribe Subscribe by URL
newsblur_unsubscribe Remove subscription
newsblur_organize_feed Move and rename feeds
newsblur_share_story Share to blurblog

Intelligence & Discovery

newsblur_train_classifier Train like/dislike by author, tag, title, feed
newsblur_get_classifiers View all training data
newsblur_discover_feeds Search and trending feeds
newsblur_manage_notifications Per-feed alerts

See it in action

Real examples of what it looks like when an AI agent connects to your NewsBlur.

"What are my infrequent stories today?"

newsblur_get_infrequent_stories

Stratechery — Agents Over Bubbles
Ben Thompson argues AI agents are fundamentally changing compute demand and he no longer believes we're in a bubble.

furbo.org — Your Mac and a Canon Printer
Craig Hockenberry deep-dives into why Canon printers constantly go "Offline" on Mac — broken Bonjour/mDNS firmware — and presents a permanent workaround.

smitten kitchen — Black Bean Confetti Salad 2.0
Deb's spring salad refresh, inspired by a Paris trip where the magnolias were blooming.

David Smith — Display Zoom Statistics
Only 1.9% of Widgetsmith users use Display Zoom — way lower than expected. Helped him decide not to support it for clear widget backgrounds.

"What are the top stories from my Hardware folder?"

newsblur_get_stories folder: "Hardware"

Adafruit — Ryugu Asteroid Samples Contain All DNA and RNA Building Blocks
All five nucleobases detected in asteroid Ryugu samples, reinforcing the theory that carbonaceous asteroids seeded early Earth's prebiotic chemistry.

Hackaday — Hacking The System In A Moral Panic
Washington State bill HB2320 would require 3D printers to phone home and refuse to print known firearms. Why it's technically infeasible.

Adafruit — Atari 2600 BASIC Programming Limitations
Warren Robinett wrote a BASIC interpreter in 64 bytes of RAM. Max 9 lines, 64 symbols, integers 0–99.

Adafruit — FPGA Replacement for Nintendo Arcade PPU
A cheap, clock-accurate FPGA replacement for the Nintendo arcade Picture Processing Unit on a 2-layer PCB.

"Save that Stratechery article and tag it ai, investing"

newsblur_save_story tags: ["ai", "investing"]

Saved Agents Over Bubbles by Ben Thompson with tags ai and investing. You can find it in your saved stories any time.

Connect in one command

Claude Code

claude mcp add --transport http newsblur https://newsblur.com/mcp/

Claude Desktop

Add to claude_desktop_config.json under mcpServers:

{
  "newsblur": {
    "type": "http",
    "url": "https://newsblur.com/mcp/"
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.newsblur]
url = "https://newsblur.com/mcp"

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "newsblur": {
      "type": "http",
      "url": "https://newsblur.com/mcp/"
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "newsblur": {
      "serverUrl": "https://newsblur.com/mcp/"
    }
  }
}

Any MCP client

Point your client at the streamable HTTP endpoint:

https://newsblur.com/mcp/

Authentication uses OAuth 2.0 — your client will handle the flow automatically.

On first use, a browser window opens for you to log in and authorize access.

Command-line interface

Everything the MCP server can do, from your terminal. Pipe to jq, script your workflows, or just browse your feeds.

Install

pip install newsblur

Login

newsblur auth login

Opens your browser to authorize. Token stored locally at ~/.config/newsblur/.

Use

newsblur stories list                          # unread stories
newsblur stories list --folder Tech --limit 5  # filter by folder
newsblur stories search "machine learning"     # full-text search
newsblur stories saved --tag research          # saved stories by tag
newsblur briefing                              # AI daily briefing
newsblur feeds list                            # all subscriptions
newsblur feeds add https://example.com         # subscribe
newsblur save 123:abc --tag ai                 # save with tags
newsblur train like --feed 42 --author "Name"  # train classifier
newsblur discover trending                     # trending feeds
newsblur stories list --json | jq '.items[].title'  # pipe to jq

What is MCP?

The Model Context Protocol is an open standard for connecting AI agents to external tools and data. It lets Claude, Codex, and other AI assistants interact with NewsBlur on your behalf.

What can an AI agent do with my NewsBlur?

Anything you can do: read stories, save and tag articles, mark stories as read, train your intelligence filters, subscribe to new feeds, and search your archive. Common workflows include daily briefings, inbox triage, and research across saved stories.

Is my data safe?

The MCP server uses OAuth, the same authentication used by third-party apps. You authorize access through your browser, and you can revoke access at any time. The MCP server never stores your credentials.