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 分