# Send Miniflux to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-miniflux",
    "name": "Miniflux",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/sinhong2011/openclaw-miniflux",
    "canonicalUrl": "https://clawhub.ai/sinhong2011/openclaw-miniflux",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/openclaw-miniflux",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-miniflux",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-miniflux"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-miniflux",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-miniflux",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-miniflux/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-miniflux/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-miniflux/agent.md"
  }
}
```
## Documentation

### What it does

Provides access to a Miniflux RSS reader instance through 13 read tools
and 10 write tools. Agents can browse feeds, search entries by status
or date, read specific articles, check categories, and (if not in read-only
mode) create/update/delete feeds and categories, import OPML, mark entries
as read, and toggle bookmarks.

### Inputs needed

For listing entries: status, date range, starred, pagination (all optional)
For feed-specific queries: feed ID
For single items: entry ID, feed ID, or user ID
For discovery: a URL to scan for feeds
For creating categories: a title
For updating categories: category ID and new title
For deleting categories: category ID
For subscribing to feeds: a feed URL and category ID
For updating feeds: feed ID, plus optional title, category_id, feed_url, site_url, user_agent
For deleting feeds: feed ID
For OPML import: an OPML XML string
For writes: entry IDs + status, or entry ID for bookmark toggle

### openclaw-miniflux-mcp binary

Download the latest binary for your platform from
GitHub Releases:

PlatformBinaryLinux x86_64openclaw-miniflux-mcp-x86_64-unknown-linux-gnuLinux ARM64openclaw-miniflux-mcp-aarch64-unknown-linux-gnumacOS x86_64openclaw-miniflux-mcp-x86_64-apple-darwinmacOS ARM64openclaw-miniflux-mcp-aarch64-apple-darwin

Or install via Cargo:

cargo install openclaw-miniflux-mcp

### MCP server configuration

Add the MCP server to your client configuration:

With API token (recommended):

{
  "mcpServers": {
    "miniflux": {
      "command": "/path/to/openclaw-miniflux-mcp",
      "args": [],
      "env": {
        "MINIFLUX_URL": "http://localhost:8080",
        "MINIFLUX_API_TOKEN": "<your-api-token>"
      }
    }
  }
}

With username/password:

{
  "mcpServers": {
    "miniflux": {
      "command": "/path/to/openclaw-miniflux-mcp",
      "args": [],
      "env": {
        "MINIFLUX_URL": "http://localhost:8080",
        "MINIFLUX_USERNAME": "<username>",
        "MINIFLUX_PASSWORD": "<password>"
      }
    }
  }
}

Read-only mode (disables write tools):

{
  "mcpServers": {
    "miniflux": {
      "command": "/path/to/openclaw-miniflux-mcp",
      "args": ["--read-only"],
      "env": {
        "MINIFLUX_URL": "http://localhost:8080",
        "MINIFLUX_API_TOKEN": "<your-api-token>"
      }
    }
  }
}

The user will need to:

Replace the binary path with wherever they downloaded/installed it
Replace MINIFLUX_URL with their Miniflux instance URL
Get an API token from Miniflux: Settings > API Keys > Create a new API key
Restart their MCP client after saving

### Browsing feeds

Call miniflux_get_feeds to see all subscriptions
Call miniflux_get_feed_entries with a feed ID to see its entries
Call miniflux_get_entry to read a specific article

### Searching entries

Call miniflux_get_entries with filters:

status: "unread", "read", or "removed"
starred: true for bookmarked entries
after / before: Unix timestamps for date ranges
limit: Number of results (default varies, recommend 20)
order: "published_at" and direction: "desc" for newest first

### Triaging unread articles

Call miniflux_get_entries with status: "unread", limit: 20
Read interesting entries with miniflux_get_entry
Mark reviewed entries as read: miniflux_update_entry_status with status: "read"
Bookmark important ones: miniflux_toggle_bookmark

### Adding new feeds

Call miniflux_discover_subscription with a website URL to find available feeds
Present discovered feeds to the user
If needed, call miniflux_create_category to create a new category
Call miniflux_create_feed with the feed URL and category ID to subscribe

### Managing feeds

Update: miniflux_update_feed with feed ID and any fields to change (title, category_id, feed_url, site_url, user_agent)
Delete: miniflux_delete_feed with feed ID to unsubscribe
Refresh: miniflux_refresh_feed with feed ID to fetch new entries now

### Managing categories

List: miniflux_get_categories to see all categories
Create: miniflux_create_category with a title
Rename: miniflux_update_category with category ID and new title
Delete: miniflux_delete_category with category ID (feeds move to default category)

### Importing/Exporting

Export: miniflux_export_opml to get all feeds as OPML XML
Import: miniflux_import_opml with an OPML XML string to bulk-add feeds

### Guardrails

Default to small page sizes (limit=20) to avoid overwhelming responses
On 401/403 errors, tell the user to check their API token or credentials
On connection errors, tell the user to verify their MINIFLUX_URL
Confirm with the user before marking large batches of entries as read
In read-only mode, explain the limitation clearly when a write is attempted
When listing returns empty results, suggest checking filters or confirming the instance has data
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: sinhong2011
- Version: 0.1.5
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/openclaw-miniflux)
- [Send to Agent page](https://openagent3.xyz/skills/openclaw-miniflux/agent)
- [JSON manifest](https://openagent3.xyz/skills/openclaw-miniflux/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openclaw-miniflux/agent.md)
- [Download page](https://openagent3.xyz/downloads/openclaw-miniflux)