NewsBlur CLI

A command-line interface for NewsBlur, the visual intelligence RSS reader. Read feeds, manage stories, train classifiers, and more from your terminal.

Install

pip install newsblur-cli

Quick Start

# Log in (opens your browser for OAuth)
newsblur auth login

# Get your daily briefing
newsblur briefing

# List your feeds
newsblur feeds list

# Read stories from a feed
newsblur stories river --feed 42

# Search stories
newsblur stories search "machine learning"

# Save a story
newsblur save <story-hash>

# Mark stories as read
newsblur read <story-hash>

Commands

Command	Description
`newsblur auth login`	Log in via OAuth
`newsblur auth logout`	Log out and remove credentials
`newsblur auth status`	Show authentication status
`newsblur briefing`	Daily briefing of top stories
`newsblur stories river`	Read stories from feeds or folders
`newsblur stories search`	Search across stories
`newsblur feeds list`	List subscribed feeds
`newsblur feeds add`	Subscribe to a new feed
`newsblur feeds remove`	Unsubscribe from a feed
`newsblur train show`	View intelligence classifiers
`newsblur train set`	Train a classifier
`newsblur discover`	Find new feeds by topic
`newsblur account`	Show account info
`newsblur save`	Save a story
`newsblur read`	Mark a story as read

Self-Hosted

For self-hosted NewsBlur instances, pass --server:

newsblur auth login --server https://nb.example.com

The server URL is persisted to ~/.config/newsblur/config.json.

Output Formats

# Rich terminal output (default)
newsblur feeds list

# JSON output (for scripting)
newsblur --json feeds list

# Raw text output
newsblur --raw feeds list

MCP Server

This package also includes an MCP (Model Context Protocol) server for AI assistants. See NewsBlur MCP Server for details.

Requirements

Python 3.11+
A NewsBlur account (premium required for most features)

Release files for newsblur-cli 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for newsblur-cli 0.2.2
File	Size	Uploaded
newsblur_cli-0.2.2.tar.gz	105.4 kB	Aug 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for newsblur-cli 0.2.2
File	Interpreter	ABI	Platform	Reset
newsblur_cli-0.2.2-py3-none-any.whl 50.0 kB Aug 11, 2026	Python 3	none	any	Details

Total release size: 155.3 kB

Release files / newsblur_cli-0.2.2.tar.gz

Download URL	newsblur_cli-0.2.2.tar.gz
Size	105.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`5f1a47d94690e56cad04e6b23121cb7eab4d69243a8cf0ade962a99b156cd9e5`
BLAKE2b-256 checksum How to use checksums	`7793e54a0f246301cd76bbad13e9263f4c4f542f2eabccc91fb54e795aa09333`
Upload date	Aug 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/samuelclay/NewsBlur
Publishing commit: github.com/samuelclay/NewsBlur/tree/330e1167402bfbe1ee39cf81d0c8e9daa7b283df

Workflow

Publishing configuration: github.com/samuelclay/NewsBlur/blob/330e1167402bfbe1ee39cf81d0c8e9daa7b283df/.github/workflows/publish-cli.yml
Publishing logs: github.com/samuelclay/NewsBlur/actions/runs/31541807822/attempts/1

Artifact

Subject: newsblur_cli-0.2.2.tar.gz
SHA-256 checksum: 5f1a47d94690e56cad04e6b23121cb7eab4d69243a8cf0ade962a99b156cd9e5 Verifying attestations

Release files / newsblur_cli-0.2.2-py3-none-any.whl

Download URL	newsblur_cli-0.2.2-py3-none-any.whl
Size	50.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ea8242d56017dd4aec9f84e04a6057a317456c8beef5e2c86aae6af36235c12b`
BLAKE2b-256 checksum How to use checksums	`c893d22e2608280828475b7f8b174495ef78492afc62b08243f4d6e9a92771d5`
Upload date	Aug 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/samuelclay/NewsBlur
Publishing commit: github.com/samuelclay/NewsBlur/tree/330e1167402bfbe1ee39cf81d0c8e9daa7b283df

Workflow

Publishing configuration: github.com/samuelclay/NewsBlur/blob/330e1167402bfbe1ee39cf81d0c8e9daa7b283df/.github/workflows/publish-cli.yml
Publishing logs: github.com/samuelclay/NewsBlur/actions/runs/31541807822/attempts/1

Artifact

Subject: newsblur_cli-0.2.2-py3-none-any.whl
SHA-256 checksum: ea8242d56017dd4aec9f84e04a6057a317456c8beef5e2c86aae6af36235c12b Verifying attestations