miniflux-mcp

Overview

The miniflux-mcp server enables seamless integration between AI assistants and Miniflux RSS readers through the Model Context Protocol. It offers comprehensive functionality across feed management, entry operations, category organization, and user management. The server supports both API key and username/password authentication methods, making it flexible for different deployment scenarios. With 40+ tools covering all Miniflux API functionality, users can interact with their RSS reader directly through AI assistants.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_feeds

  Get all RSS/Atom feeds

  Try:List all my RSS feedsTry:Show me all feeds in my Miniflux instance
• create_feed

  Add a new RSS/Atom feed

  Try:Add a new RSS feed from https://example.com/feedTry:Subscribe to this blog: https://techblog.example
• get_entries

  Get entries with optional filtering

  Try:Show me recent unread entriesTry:Get all entries from the tech category
• update_entry_status

  Update entry status (read/unread/removed)

  Try:Mark article 123 as readTry:Set all entries from Hacker News to removed
• get_categories

  Get all feed categories

  Try:Show me my feed categoriesTry:List all categories in my reader
• create_category

  Create a new category

  Try:Create a new category named 'Programming'Try:Add a category for 'Science News'
• mark_all_as_read

  Mark all entries as read for a user

  Try:Mark everything as readTry:Clear all unread entries
• get_feed_entries

  Get entries from a specific feed

  Try:Show me entries from the BBC News feedTry:Get latest posts from my favorite blog
• refresh_feed

  Manually refresh a specific feed

  Try:Refresh the Hacker News feedTry:Update my tech blog subscriptions
• get_me

  Get current user information

  Try:Show my user profileTry:Display my account details
• discover

  Discover feeds from a URL

  Try:Find RSS feeds on https://example.comTry:Discover feeds from this website
• export

  Export feeds as OPML

  Try:Export all my feeds as OPMLTry:Create a backup of my RSS subscriptions

Comparable tools

Installation

docker build -t miniflux-mcp .
docker run --env-file .env miniflux-mcp

{
  "mcpServers": {
    "miniflux": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MINIFLUX_URL",
        "-e",
        "MINIFLUX_API_KEY",
        "jwonder/miniflux-mcp:latest"
      ],
      "env": {
        "MINIFLUX_URL": "https://your-miniflux-instance.com",
        "MINIFLUX_API_KEY": "your_api_key_here"
      }
    }
  }
}

FAQ

What authentication methods are supported?

The server supports both API key authentication and basic username/password authentication. You can use either MINIFLUX_API_KEY or both MINIFLUX_USERNAME and MINIFLUX_PASSWORD environment variables.

How many tools does this MCP server provide?

The Miniflux MCP Server provides 40+ tools covering all Miniflux API functionality, including feed management, entry operations, category management, user management, system utilities, API key management, and media handling.

Compare miniflux-mcp with