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.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
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.
A Model Context Protocol (MCP) server for interacting with Miniflux RSS reader.
*Either use MINIFLUX_API_KEY OR both MINIFLUX_USERNAME and MINIFLUX_PASSWORD
stdio is the default transport and is intended for an MCP client that starts the server locally.
docker build -t miniflux-mcp .
docker run -i --rm --env-file .env miniflux-mcp
Or use the published image:
docker run -i --rm --env-file .env jwonder/miniflux-mcp:latest
.mcp.json)Add the following .mcp.json file to your project root:
{
"mcpServers": {
"miniflux": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MINIFLUX_URL",
"-e",
"MINIFLUX_API_KEY",
"jwonder/miniflux-mcp:latest"
],
"env": {
"MINIFLUX_URL": "${MINIFLUX_URL}",
"MINIFLUX_API_KEY": "${MINIFLUX_API_KEY}"
}
}
}
}
The remote server exposes a Streamable HTTP MCP endpoint protected by a static Bearer token.
Set a strong token and start the container with the Streamable HTTP transport:
export MCP_AUTH_TOKEN='replace-with-a-strong-secret'
docker run --rm \
-p 8080:8080 \
--env-file .env \
-e MCP_TRANSPORT=streamable-http \
-e MCP_AUTH_TOKEN \
jwonder/miniflux-mcp:latest
Configure an MCP client to connect to http://your-server:8080/mcp and send:
Authorization: Bearer replace-with-a-strong-secret
.mcp.json)Add the remote server to your project-level .mcp.json:
{
"mcpServers": {
"miniflux": {
"type": "http",
"url": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer ${MCP_AUTH_TOKEN}"
}
}
}
}
The unauthenticated health endpoint is available at /healthz. For deployment outside a trusted private network, put the server behind an HTTPS reverse proxy so the Bearer token is encrypted in transit. One server process uses one configured Miniflux identity, so every connected MCP client has that identity's permissions.
The Miniflux MCP Server provides 40+ tools covering all Miniflux API functionality, which can be found in the Miniflux API Reference.
Entry lists (get_entries, get_feed_entries, and get_category_entries) retain article content, metadata, and pagination totals, but return only compact nested feed metadata: id, title, feed_url, disabled, and category id/title when available. Use get_feed for full feed details, including configuration and parsing errors.
get_feeds - List RSS/Atom feeds with their IDs, titles, feed URLs, disabled status, and categoriesget_feed - Get a specific feed by IDcreate_feed - Add a new RSS/Atom feedupdate_feed - Update an existing feeddelete_feed - Delete a specific feedrefresh_feed - Manually refresh a specific feedrefresh_all_feeds - Refresh all feedsget_feed_entries - Get entries from a specific feedget_feed_entry - Get a specific entry from a feedget_feed_icon - Get the icon of a specific feedmark_feed_as_read - Mark all entries in a feed as readget_entries - Get entries with optional filteringget_entry - Get a specific entry by IDupdate_entry_status - Update entry status (read/unread/removed)toggle_starred - Toggle starred status of an entrysave_entry - Save an entryfetch_original_content - Fetch original content of an entrymark_all_as_read - Mark all entries as read for a userget_category_entry - Get a specific entry from a categoryget_categories - Get all feed categoriescreate_category - Create a new categoryupdate_category - Update a category titledelete_category - Delete a categoryget_category_feeds - Get all feeds in a specific categoryget_category_entries - Get all entries in a specific categorymark_category_as_read - Mark all entries in a category as readrefresh_category - Refresh all feeds in a categoryget_users - Get all usersget_me - Get current user informationget_user_by_id - Get a specific user by IDget_user_by_username - Get a specific user by usernamecreate_user - Create a new userdelete_user - Delete a userget_version - Get Miniflux version informationhealthcheck - Perform a health checkfetch_counters - Fetch feed countersdiscover - Discover feeds from a URLexport - Export feeds as OPMLflush_history - Flush the read historyget_api_keys - Get all API keyscreate_api_key - Create a new API keydelete_api_key - Delete an API keyget_icon - Get an icon by IDget_enclosure - Get an enclosure by IDThis project is licensed under the MIT License - see the LICENSE file for details.
For issues and questions:
A Model Context Protocol (MCP) server for interacting with Miniflux RSS reader.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Miniflux 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 A Model Context Protocol (MCP) server for interacting with Miniflux RSS reader.