mcp-feed-reader-crunchtools

Secure MCP server for RSS/Atom feed reading with SQLite backend.

Installation

uvx (recommended)

uvx mcp-feed-reader-crunchtools

pip

pip install mcp-feed-reader-crunchtools

Container

podman run -v feedreader-data:/data quay.io/crunchtools/mcp-feed-reader

Configuration

Variable	Default	Description
`FEED_READER_DB`	`~/.local/share/mcp-feed-reader/feeds.db`	SQLite database path

Tools (17)

Feed Management

add_feed_tool — Add an RSS/Atom feed by URL
list_feeds_tool — List all feeds with unread counts
get_feed_tool — Get feed details
delete_feed_tool — Remove a feed
refresh_feeds_tool — Crawl feed sources for new content (slow, prefer systemd timer)

Entry Management

list_entries_tool — List entries (filterable, paginated)
read_entry_tool — Read full entry content (auto-marks read)
mark_read_tool — Mark entries as read
mark_unread_tool — Mark entry as unread
search_entries_tool — Full-text search (FTS5)

Category Management

list_categories_tool — List categories with counts
create_category_tool — Create category
rename_category_tool — Rename category
delete_category_tool — Delete category

Import/Export

import_opml_tool — Import from OPML file
export_opml_tool — Export as OPML
get_stats_tool — Dashboard stats

Background Fetching

# Fetch all feeds via CLI
mcp-feed-reader-crunchtools --fetch

License

AGPL-3.0-or-later

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_feed_reader_crunchtools-0.2.1.tar.gz (42.6 kB view details)

Uploaded Aug 30, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mcp_feed_reader_crunchtools-0.2.1-py3-none-any.whl (29.8 kB view details)

Uploaded Aug 30, 2026 Python 3

File details

Details for the file mcp_feed_reader_crunchtools-0.2.1.tar.gz.

File metadata

Download URL: mcp_feed_reader_crunchtools-0.2.1.tar.gz
Upload date: Aug 30, 2026
Size: 42.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mcp_feed_reader_crunchtools-0.2.1.tar.gz
Algorithm	Hash digest
SHA256	`c2a993cf7b47197dc62bd57bffcab0552b0a380f934c50f798b02f22fe74d0c0`
MD5	`4e767de34d7e00a8bc825b1889b1d63d`
BLAKE2b-256	`5ab9fc82622a77260c1a849828134510c510bf5988a26d8775f1b1c05c806397`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_feed_reader_crunchtools-0.2.1.tar.gz:

Publisher: publish.yml on crunchtools/mcp-feed-reader

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mcp_feed_reader_crunchtools-0.2.1.tar.gz
- Subject digest: c2a993cf7b47197dc62bd57bffcab0552b0a380f934c50f798b02f22fe74d0c0
- Sigstore transparency entry: 2654611943
- Sigstore integration time: Aug 30, 2026
Source repository:
- Permalink: crunchtools/mcp-feed-reader@d1ab88b168ceb8be29d9702f30c3104af196b79e
- Branch / Tag: refs/tags/v0.2.1
- Owner: https://github.com/crunchtools
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@d1ab88b168ceb8be29d9702f30c3104af196b79e
- Trigger Event: release

File details

Details for the file mcp_feed_reader_crunchtools-0.2.1-py3-none-any.whl.

File metadata

Download URL: mcp_feed_reader_crunchtools-0.2.1-py3-none-any.whl
Upload date: Aug 30, 2026
Size: 29.8 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mcp_feed_reader_crunchtools-0.2.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`aa7c151fef6a50fc62a73efd613a1212fab06b7c2257d96a8a46e3ca66a23943`
MD5	`cafad72ce8579a9afe712a9ec731eac3`
BLAKE2b-256	`990bc1f5d02f8e919e01fb3d91942ea7ac689b5ed01e4f34402f60c12c7e4a23`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_feed_reader_crunchtools-0.2.1-py3-none-any.whl:

Publisher: publish.yml on crunchtools/mcp-feed-reader

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mcp_feed_reader_crunchtools-0.2.1-py3-none-any.whl
- Subject digest: aa7c151fef6a50fc62a73efd613a1212fab06b7c2257d96a8a46e3ca66a23943
- Sigstore transparency entry: 2654612003
- Sigstore integration time: Aug 30, 2026
Source repository:
- Permalink: crunchtools/mcp-feed-reader@d1ab88b168ceb8be29d9702f30c3104af196b79e
- Branch / Tag: refs/tags/v0.2.1
- Owner: https://github.com/crunchtools
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@d1ab88b168ceb8be29d9702f30c3104af196b79e
- Trigger Event: release

Release history Release notifications | RSS feed

This release

0.2.1 This release

Aug 30, 2026 2 files

Aug 30, 2026 2 files

Mar 9, 2026 2 files

Mar 8, 2026 2 files

Mar 8, 2026 2 files

mcp-feed-reader-crunchtools 0.2.1

mcp-feed-reader-crunchtools

Installation

uvx (recommended)

pip

Container

Configuration

Tools (17)

Feed Management

Entry Management

Category Management

Import/Export

Background Fetching

License

Key dates

1 maintainer

Credits

License expression

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed