Inoreader MCP Server

An MCP (Model Context Protocol) server that provides RSS feed management capabilities through the Inoreader API. This enables LLMs like Claude to read and manage RSS feeds on your behalf.

Built with Bun for fast startup and low memory usage.

Features

• OAuth2 authentication - Browser-based login with secure keychain storage
• Automatic token refresh - Tokens are refreshed automatically when expired
• Read articles - Get unread, starred, or all articles from your feeds
• Manage subscriptions - Add or remove RSS feed subscriptions
• Organize content - Mark articles as read/unread, star articles, add tags
• Browse feeds - List subscriptions, folders, tags, and unread counts

Requirements

• Bun 1.0+
• Inoreader Pro account (API access requires Pro subscription)
• Inoreader API credentials (App ID and App Key)
• macOS: Keychain (built-in)
• Linux: libsecret (apt install libsecret-tools)

Installation

Quick Start (via bunx)

No installation required - run directly from GitHub:

bunx github:seiji/inoreader-mcp-server          # latest
bunx github:seiji/inoreader-mcp-server#v0.4.0   # specific version

Local Development

git clone https://github.com/seiji/inoreader-mcp-server.git
cd inoreader-mcp-server
bun install

Authentication

1. Get API Credentials

1. Go to Inoreader Developer Portal
2. Register a new application with these settings:
   • Redirect URI: http://localhost:19812/callback
   • Scopes: read and write
3. Note your App ID and App Key

2. Set Environment Variables

export INOREADER_APP_ID="your-app-id"
export INOREADER_APP_KEY="your-app-key"

3. Login

# This opens your browser for OAuth authentication
bunx github:seiji/inoreader-mcp-server auth login

Alternatively, authenticate from your MCP client: call the auth_login tool, open the returned URL in a browser, then call auth_complete.

Tokens are securely stored in your system keychain:

• macOS: Keychain Access
• Linux: GNOME Keyring / KDE Wallet (via libsecret)

To bypass the keychain, set INOREADER_ACCESS_TOKEN. It takes priority over tokens stored in the keychain.

Auth Commands

# Login - opens browser for OAuth authentication
bunx github:seiji/inoreader-mcp-server auth login

# Check authentication status
bunx github:seiji/inoreader-mcp-server auth status

# Logout - remove tokens from keychain
bunx github:seiji/inoreader-mcp-server auth logout

Usage

Running the Server

# Via bunx (recommended)
bunx github:seiji/inoreader-mcp-server

# Local development
bun run start

MCP Client Configuration

Install the server with your MCP client. INOREADER_APP_ID and INOREADER_APP_KEY are required for login and token refresh.

Standard config works in most of the tools:

{
  "mcpServers": {
    "inoreader": {
      "command": "bunx",
      "args": ["github:seiji/inoreader-mcp-server"],
      "env": {
        "INOREADER_APP_ID": "your-app-id",
        "INOREADER_APP_KEY": "your-app-key"
      }
    }
  }
}

Do not commit project-scoped config files that contain your App Key.

After configuring, authenticate once with bunx github:seiji/inoreader-mcp-server auth login (with the environment variables set in your shell) or with the auth_login / auth_complete tools. Tokens are stored in keychain and automatically refreshed.

Available Tools

Example Interactions

Once configured in your MCP client, you can ask:

• “Show me my unread articles”
• “What are my RSS subscriptions?”
• “Subscribe to https://example.com/feed.xml”
• “Mark all articles in my Tech folder as read”
• “Star the first article about AI”
• “How many unread articles do I have?”

Contributing

See CONTRIBUTING.md for development and testing commands, PR title conventions, the squash merge policy, versioning rules, and release procedures.

The draft MCP specification defines the public contract and pending design decisions. See specification-to-test coverage for tested scenarios and remaining gaps.

Maintainers: see Repository Administration for the release GitHub App setup and required PR title check settings.

Troubleshooting

“Keychain is not available”

Linux: Install libsecret-tools:

sudo apt install libsecret-tools

“Token expired” errors

Run bunx github:seiji/inoreader-mcp-server auth login to re-authenticate.

Disclaimer

This project is an unofficial, community-developed tool and is not affiliated with, endorsed by, or sponsored by Inoreader. “Inoreader” is a trademark of Innologica Ltd.

To use this MCP server, you must:

• Have your own Inoreader Pro subscription (API access requires Pro)
• Register your own application at the Inoreader Developer Portal
• Comply with Inoreader’s Terms of Service

This project does not include any API keys or tokens. Each user must obtain their own credentials.

License

MIT