wallabag MCP
If you self-host wallabag as your read-it-later service, this server wraps its OAuth API into MCP tools for managing your article queue. You get the usual entry operations like save, archive, star, reload extraction, and delete, plus tag management and annotations on highlighted text. It handles the password grant flow so you can skip manual token juggling. Useful when you want Claude to triage your reading list, pull full content for summarization, or tag articles based on their extracted text. Configuration lives in environment variables and it ships with both mocked tests and a live doc validator against wallabag's public API.
- tools
- 17
- auth
- Secret needed
- transport
- STDIO
- env vars
- 6
- last updated
- May 18, 2026
Tools
17 toolsPublic tool metadata for what this MCP can expose to an agent.
wallabag_health_checkVerify connectivity and authentication with a tiny read-only request
Verify connectivity and authentication with a tiny read-only request
No parameter schema in public metadata yet.
wallabag_list_entriesList entries with pagination and filters
List entries with pagination and filters
No parameter schema in public metadata yet.
wallabag_get_entryFetch one entry, optionally including extracted content
Fetch one entry, optionally including extracted content
No parameter schema in public metadata yet.
wallabag_add_entrySave a URL into wallabag
Save a URL into wallabag
No parameter schema in public metadata yet.
wallabag_update_entryUpdate title, URL, archive/starred state, or tags
Update title, URL, archive/starred state, or tags
No parameter schema in public metadata yet.
wallabag_archive_entryMark an entry archived/read
Mark an entry archived/read
No parameter schema in public metadata yet.
wallabag_unarchive_entryMark an entry unarchived/unread
Mark an entry unarchived/unread
No parameter schema in public metadata yet.
wallabag_star_entryStar/favourite an entry
Star/favourite an entry
No parameter schema in public metadata yet.
wallabag_unstar_entryRemove starred/favourite state
Remove starred/favourite state
No parameter schema in public metadata yet.
wallabag_reload_entryAsk wallabag to refetch/reparse the original URL
Ask wallabag to refetch/reparse the original URL
No parameter schema in public metadata yet.
wallabag_delete_entryDelete an entry
Delete an entry
No parameter schema in public metadata yet.
wallabag_list_tagsList known tags
List known tags
No parameter schema in public metadata yet.
wallabag_add_tags_to_entryAdd comma-separated tags to an entry
Add comma-separated tags to an entry
No parameter schema in public metadata yet.
wallabag_delete_tagDelete a tag globally
Delete a tag globally
No parameter schema in public metadata yet.
wallabag_list_annotationsList annotations for an entry
List annotations for an entry
No parameter schema in public metadata yet.
wallabag_create_annotationCreate an annotation on quoted article text
Create an annotation on quoted article text
No parameter schema in public metadata yet.
wallabag_delete_annotationDelete an annotation
Delete an annotation
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
WALLABAG_BASE_URL*Base URL of the wallabag instance, e.g. https://wallabag.example.com
WALLABAG_ACCESS_TOKENsecretExisting OAuth access token; skips password grant if provided
WALLABAG_CLIENT_IDOAuth client id; required unless WALLABAG_ACCESS_TOKEN is set
WALLABAG_CLIENT_SECRETsecretOAuth client secret; required unless WALLABAG_ACCESS_TOKEN is set
WALLABAG_USERNAMEwallabag username; required unless WALLABAG_ACCESS_TOKEN is set
WALLABAG_PASSWORDsecretwallabag password; required unless WALLABAG_ACCESS_TOKEN is set
Readme
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:
Details
- Repository
- github.com/rusty4444/wallabag-mcp
- Website
- github.com/rusty4444/wallabag-mcp
- Package
wallabag-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active