reading-feed-mcp

reading-feed-mcp

Your reading queue, searchable from Claude Code. Stop re-googling what you already saved.

One MCP server. Five reading sources. Zero vendor lock-in.

The problem

Every Claude Code session starts amnesiac. You saved 300 articles this year. You remember reading something about the exact pattern you're implementing right now. But it's in Readwise. Or Pocket. Or Karakeep. Or Burn. Or that folder of markdown notes.

So you re-google. Again.

claude-code#27298 has 22 comments about this. Readwise built their own MCP — but it only works if you use Readwise. Everyone else is stuck.

The fix

reading-feed-mcp is a vendor-neutral MCP server that makes your reading queue queryable from any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf).

Configure one or more sources. Get three tools:

• search_reading(query) — full-text search across everything
• list_recent(source) — latest items from a source
• list_sources — what you've wired up

That's it. No new account. No cloud. No lock-in.

Supported sources

Source	What you need	Status
Burn 451	BURN_MCP_TOKEN	✅
Readwise Reader	READWISE_TOKEN	✅
Karakeep (self-hosted)	KARAKEEP_URL + KARAKEEP_TOKEN	✅
RSS feeds	READING_FEED_RSS (comma-separated URLs)	✅
Local markdown	READING_FEED_MARKDOWN_DIR	✅
Raindrop / Omnivore / Pocket export	—	🔜 v0.2

Configure any combination. Search spans all of them.

Setup (60 seconds)

1. Install

claude mcp add reading-feed -- npx reading-feed-mcp@latest

2. Set sources via env vars

At least one required. Use whichever you actually have:

# Burn 451 — get token at burn451.cloud/settings
export BURN_MCP_TOKEN=bmcp_xxx

# Readwise Reader — get token at readwise.io/access_token
export READWISE_TOKEN=xxx

# Karakeep (self-hosted)
export KARAKEEP_URL=https://karakeep.your-domain.com
export KARAKEEP_TOKEN=xxx

# RSS feeds (comma-separated)
export READING_FEED_RSS="https://simonwillison.net/atom/everything/,https://karpathy.bearblog.dev/feed/"

# Local markdown notes
export READING_FEED_MARKDOWN_DIR=~/notes

3. Use it

In Claude Code, just ask:

> Find articles I saved about MCP authentication

Claude calls search_reading(query="MCP authentication") and returns matches across all your sources.

Example output

{
  "query": "MCP authentication",
  "total": 4,
  "results": [
    {
      "source": "burn",
      "title": "MCP Auth Patterns in 2026",
      "url": "https://example.com/mcp-auth",
      "status": "active",
      "summary": "Compares OAuth device flow, API keys, and JWT exchange for MCP servers..."
    },
    {
      "source": "readwise",
      "title": "Building Secure MCP Servers",
      "url": "https://example.com/secure-mcp",
      "status": "later",
      "summary": "Step-by-step guide to token exchange..."
    },
    {
      "source": "rss",
      "title": "Simon Willison: MCP Server Deep Dive",
      "url": "https://simonwillison.net/...",
      "feed": "Simon Willison's Weblog"
    }
  ]
}

Why "vendor-neutral" matters

Most reading tools want you to use their ecosystem. Readwise MCP is Readwise-only. Pocket is dead. Omnivore is dead. If your reading tool dies, your reading dies with it.

reading-feed-mcp is the opposite: bring your own source. Switch services, keep the MCP. We don't store your data. We don't host anything. We're a thin query layer.

Best with Burn — but works with anything

Burn 451 is recommended because:

• 24h countdown surfaces urgency (search result has status: "active" with time remaining)
• AI summaries embedded in every article (search works on summaries, not just titles)
• Free tier, no credit card

But the whole point is you don't have to use Burn. If you live in Readwise, use Readwise. Live in markdown files? Point the MCP at your folder.

How it's built

• Zero-dep Node.js (except @modelcontextprotocol/sdk)
• Each source is one file (<100 lines) — add a new one via PR in 20 minutes
• Stdio transport (standard MCP pattern)
• Token caching (5-min TTL) so you don't thrash upstream APIs

Part of the Burn ecosystem

Tool	What it does
reading-feed-mcp (this)	Vendor-neutral MCP for any reading source
burn-mcp-server	Burn-specific MCP (26 tools, full control)
burn451 CLI	Terminal queue management
burn-claude-skill	/burn command for CC
burn-daily-triage	Daily CC Routine template
morning-brief	Daily briefing CLI
reading-digest	Weekly digest generator

Contributing

New source adapter? Each one lives in src/sources/<name>.mjs, exports search({...}) and listRecent({...}). See src/sources/burn.mjs for the simplest example (~50 lines).

License

MIT