Miniflux MCP Server

A Model Context Protocol (MCP) server for interacting with Miniflux RSS reader. This server provides tools to manage feeds, entries, users, and categories through the MCP protocol using Miniflux Client.

Features

• Feed Management: List, create, and refresh RSS/Atom feeds
• Entry Operations: Read entries, update status (read/unread/removed)
• Category Management: List and organize feed categories
• Flexible Authentication: Support for both API key and username/password authentication

Setup Instructions

Getting a Miniflux API Key

1. Log into your Miniflux instance
2. Go to Settings → API Keys
3. Create a new API key
4. Copy the generated key to your configuration

Using Docker

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

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | MINIFLUX_URL | Your Miniflux instance URL | Yes | | MINIFLUX_API_KEY | API key for authentication | Yes* | | MINIFLUX_USERNAME | Username for basic auth | Yes* | | MINIFLUX_PASSWORD | Password for basic auth | Yes* |

*Either use MINIFLUX_API_KEY OR both MINIFLUX_USERNAME and MINIFLUX_PASSWORD

Getting a Miniflux API Key

1. Log into your Miniflux instance
2. Go to Settings → API Keys
3. Create a new API key
4. Copy the generated key to your configuration

Docker Run

# Setup .env file
# Run
docker run -i --rm --env-file .env jwonder/miniflux-mcp:latest

Integration with Claude Desktop

To use this MCP server with Claude Desktop, add the following to your Claude Desktop configuration:

{
  "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"
        // Or use username/password instead of API key
        // "MINIFLUX_USERNAME": "your_username_here",
        // "MINIFLUX_PASSWORD": "your_password_here"
      }
    }
  }
}

Available Tools

The Miniflux MCP Server provides 40+ tools covering all Miniflux API functionality, which can be found in the Miniflux API Reference.

Feed Management (10 tools)

• get_feeds - Get all RSS/Atom feeds
• get_feed - Get a specific feed by ID
• create_feed - Add a new RSS/Atom feed
• delete_feed - Delete a specific feed
• refresh_feed - Manually refresh a specific feed
• refresh_all_feeds - Refresh all feeds
• get_feed_entries - Get entries from a specific feed
• get_feed_entry - Get a specific entry from a feed
• get_feed_icon - Get the icon of a specific feed
• mark_feed_as_read - Mark all entries in a feed as read

Entry Management (8 tools)

• get_entries - Get entries with optional filtering
• get_entry - Get a specific entry by ID
• update_entry_status - Update entry status (read/unread/removed)
• toggle_bookmark - Toggle bookmark status of an entry
• save_entry - Save an entry
• fetch_original_content - Fetch original content of an entry
• mark_all_as_read - Mark all entries as read for a user
• get_category_entry - Get a specific entry from a category

Category Management (8 tools)

• get_categories - Get all feed categories
• create_category - Create a new category
• update_category - Update a category title
• delete_category - Delete a category
• get_category_feeds - Get all feeds in a specific category
• get_category_entries - Get all entries in a specific category
• mark_category_as_read - Mark all entries in a category as read
• refresh_category - Refresh all feeds in a category

User Management (6 tools)

• get_users - Get all users
• `

... View full README on GitHub