MCP.Market

wallabag MCP server

by rusty4444·io.github.rusty4444/wallabag-mcp·v0.1.0·3 stars
No reviews yet

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

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

3 stars16 downloads/wk

Reviews

Write one

Nobody has reviewed wallabag MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

wallabag MCP tools (17, 6 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • wallabag_add_entry

    Save a URL as a wallabag entry.

  • wallabag_add_tags_to_entry

    Add one or more tags to a wallabag entry.

  • wallabag_archive_entry

    Mark a wallabag entry as archived/read.

  • wallabag_create_annotationwrite action

    Create an annotation on a wallabag entry.

  • wallabag_delete_annotationwrite action

    Delete a wallabag annotation.

  • wallabag_delete_entrywrite action

    Delete a wallabag entry.

  • wallabag_delete_tagwrite action

    Delete a wallabag tag globally.

  • wallabag_get_entry

    Get a wallabag entry/article by id.

  • wallabag_health_check

    Verify wallabag API connectivity and authentication with a tiny read-only request.

  • wallabag_list_annotations

    List annotations for a wallabag entry.

  • wallabag_list_entries

    List wallabag entries/articles with filters and pagination.

  • wallabag_list_tags

    List tags known to the wallabag account.

  • wallabag_reload_entry

    Ask wallabag to refetch/reparse the original article URL.

  • wallabag_star_entry

    Mark a wallabag entry as starred/favourite.

  • wallabag_unarchive_entry

    Mark a wallabag entry as unarchived/unread.

  • wallabag_unstar_entrywrite action

    Remove starred/favourite state from a wallabag entry.

  • wallabag_update_entrywrite action

    Update metadata/state for a wallabag entry.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan6 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 119 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How wallabag MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 38% of 48,255 servers
Tools
17
the typical server has 7
Tools that change things
35%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
3
more than 80% of 28,688 servers
Downloads a week
16
more than 4% of 12,191 servers with a package

What its tools let an agent do: 11 read · 6 change

Install wallabag MCP in Claude Code, Cursor or VS Code

claude mcp add wallabag-mcp -- uvx wallabag-mcp
Add to Cursor

What the publisher says

From the wallabag MCP repository's README, as published. We do not edit it. Read it on GitHub

wallabag MCP

<!-- mcp-name: io.github.rusty4444/wallabag-mcp -->

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

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

Or from a checkout:

python -m venv .venv
source .venv/bin/activate
pip install -e .

Configuration

The server reads configuration from environment variables:

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

{
  "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

Development and validation

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
ruff check .
pytest
python scripts/live_docs_test.py

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

wallabag MCP: common questions

Is wallabag MCP server safe?
Mostly: it is graded B (72/100). Read the wallabag MCP safety report
How do I install wallabag MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does wallabag MCP need an API key?
Yes. The registry entry asks for WALLABAG_ACCESS_TOKEN, WALLABAG_CLIENT_SECRET, WALLABAG_PASSWORD.
Is wallabag MCP maintained?
The last commit was 157 days ago (2026-05-31). The latest release is v0.1.0.
How does wallabag MCP compare with other MCP servers?
safety score 72/100 (higher than 38% of 48,255 servers); tools 17 (the typical server has 7); tools that change things 35% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from rusty4444 →