FeedbinMCP
This project was generated almost entirely by Claude Code, Anthropic's AI coding assistant, with only minor human editing.
An MCP server that connects Claude to your Feedbin RSS account. Read articles, manage read/unread state, and star or unstar entries — all from a Claude conversation.
Tools
| Tool | Description |
|---|---|
get_subscriptions | List all subscribed feeds |
get_feed | Get details for a specific feed |
get_unread_entries | Paginated unread articles |
get_read_entries | Paginated read articles |
get_starred_entries | Paginated starred articles |
get_entries | Entries with filters (feed, date, IDs) |
get_entry | Full content for a single entry |
get_unread_entry_ids | Flat list of all unread IDs |
get_starred_entry_ids | Flat list of all starred IDs |
mark_entries_read | Mark one or more entries as read |
mark_entries_unread | Mark one or more entries as unread |
star_entries | Star (bookmark) entries |
unstar_entries | Remove star from entries |
get_tags | List all tags |
get_taggings | Feed-to-tag mappings |
Requirements
Installation
# 1. Clone the repo
git clone https://github.com/hypermoose/FeedbinMCP.git
cd FeedbinMCP
# 2. Install the package and its dependencies
pip install -e .
This installs a feedbin-mcp command and all required dependencies (mcp, httpx).
To confirm the install worked:
feedbin-mcp --help
Adding to Claude Code
Run this once, substituting your real Feedbin credentials:
claude mcp add feedbin \
--env FEEDBIN_EMAIL=you@example.com \
--env FEEDBIN_PASSWORD=your_password \
-- feedbin-mcp
Verify it's registered:
claude mcp list
The server will be available in all Claude Code sessions. Type /mcp inside a session to confirm it's connected.
Credentials
Feedbin uses HTTP Basic Auth (email + password). The server reads credentials from two environment variables:
| Variable | Description |
|---|---|
FEEDBIN_EMAIL | Your Feedbin account email |
FEEDBIN_PASSWORD | Your Feedbin account password |
These are passed via --env in the claude mcp add command above and are never stored in the repository.
Running directly (without installing)
If you prefer not to install the package, you can run the server directly with Python after installing dependencies:
pip install mcp[cli] httpx
FEEDBIN_EMAIL=you@example.com \
FEEDBIN_PASSWORD=your_password \
python feedbin_mcp/server.py
And reference it in Claude Code as:
claude mcp add feedbin \
--env FEEDBIN_EMAIL=you@example.com \
--env FEEDBIN_PASSWORD=your_password \
-- python /path/to/FeedbinMCP/feedbin_mcp/server.py