wallabag MCP

io.github.rusty4444由 GitHub 帳號 rusty4444 發布v0.1.0更新於 Oct 24, 2026

MCP server for wallabag read-it-later entries, tags, and annotations.

已驗證STDIO僅桌面效率與工作流知識與記憶

概覽

AI 產生的概覽

wallabag 的 MCP 伺服器，讓助理瀏覽、儲存與整理稍後閱讀文章、標籤和註解。

可以做什麼
檢查連線與驗證狀態，並列出、篩選與分頁瀏覽已儲存文章，取得單篇中繼資料或擷取後的全文。
適用情境
當你使用 wallabag（自架或託管）並希望助理能直接整理稍後閱讀清單時適用：瀏覽與篩選文章、取出全文、儲存新網址、標記已讀或星號，以及管理標籤與註解。
執行需求
在本機以 Python 套件執行（uvx 或 pipx）。需要 WALLABAG_BASE_URL，以及 WALLABAG_ACCESS_TOKEN，或 WALLABAG_CLIENT_ID、WALLABAG_CLIENT_SECRET、WALLABAG_USERNAME、WALLABAG_PASSWORD 這組 OAuth 密碼授權憑證；可選 WALLABAG_TIMEOUT。需能連線至 wallabag 執行個體。
安裝前請注意
多數工具會修改你的 wallabag 資料庫：儲存網址、更新標題或狀態、封存、加星、重新擷取、刪除文章、新增或刪除標籤，以及建立或刪除註解。刪除標籤是全域操作。需提供 WALLABAG_CLIENT_SECRET、WALLABAG_PASSWORD 或 WALLABAG_ACCESS_TOKEN 等機密，應放在環境變數或密鑰管理工具中，勿提交到版本控制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 wallabag MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

wallabag MCP

[Buy Me A Coffee]

A Model Context Protocol (MCP) server for wallabag, the open-source read-it-later service.

This server gives AI assistants a structured interface for common wallabag workflows:

  • Verify connectivity and authentication with a tiny read-only health check
  • List, filter, and page through saved articles
  • Fetch entry metadata or full extracted content
  • Save new URLs
  • Archive/unarchive and star/unstar entries
  • Reload/refetch article extraction
  • Delete entries
  • List and add tags
  • List, create, and delete annotations

Why this exists

wallabag is widely used in self-hosted setups, but its API is OAuth-based and awkward for general LLM tools. This MCP server wraps the important entry, tag, and annotation operations with an AI-friendly surface and documented parameters.

Installation

bash
pipx install git+https://github.com/rusty4444/wallabag-mcp.git

Or from a checkout:

bash
python -m venv .venvsource .venv/bin/activatepip install -e .

Configuration

The server reads configuration from environment variables:

VariableRequiredDescription
WALLABAG_BASE_URLYesBase URL of your wallabag instance, e.g. https://app.wallabag.it
WALLABAG_ACCESS_TOKENOptionalExisting OAuth access token; if set, password grant is skipped
WALLABAG_CLIENT_IDRequired unless access token is setOAuth client id from wallabag's developer client page
WALLABAG_CLIENT_SECRETRequired unless access token is setOAuth client secret
WALLABAG_USERNAMERequired unless access token is setwallabag username
WALLABAG_PASSWORDRequired unless access token is setwallabag password
WALLABAG_TIMEOUTNoHTTP timeout in seconds, default 20

Create a wallabag API client from your wallabag instance under Developer / API clients. wallabag's official docs show the password grant against /oauth/v2/token.

MCP client config

json
{  "mcpServers": {    "wallabag": {      "command": "wallabag-mcp",      "env": {        "WALLABAG_BASE_URL": "https://wallabag.example.com",        "WALLABAG_CLIENT_ID": "your-client-id",        "WALLABAG_CLIENT_SECRET": "your-client-secret",        "WALLABAG_USERNAME": "your-username",        "WALLABAG_PASSWORD": "your-password"      }    }  }}

Tools

ToolPurpose
wallabag_health_checkVerify connectivity and authentication with a tiny read-only request
wallabag_list_entriesList entries with pagination and filters
wallabag_get_entryFetch one entry, optionally including extracted content
wallabag_add_entrySave a URL into wallabag
wallabag_update_entryUpdate title, URL, archive/starred state, or tags
wallabag_archive_entryMark an entry archived/read
wallabag_unarchive_entryMark an entry unarchived/unread
wallabag_star_entryStar/favourite an entry
wallabag_unstar_entryRemove starred/favourite state
wallabag_reload_entryAsk wallabag to refetch/reparse the original URL
wallabag_delete_entryDelete an entry
wallabag_list_tagsList known tags
wallabag_add_tags_to_entryAdd comma-separated tags to an entry
wallabag_delete_tagDelete a tag globally
wallabag_list_annotationsList annotations for an entry
wallabag_create_annotationCreate an annotation on quoted article text
wallabag_delete_annotationDelete an annotation

Development and validation

bash
python -m venv .venvsource .venv/bin/activatepip install -e '.[dev]'ruff check .pytestpython scripts/live_docs_test.py

live_docs_test.py validates wallabag's public API documentation and the hosted API docs page without needing account credentials. Mutation and authenticated request behaviours are covered with mocked HTTP tests.

Safety

Write-capable tools mutate your read-it-later library. Keep OAuth secrets in environment variables or a secret manager, never in source control.

來源：README.md，提交 f30fc83

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分