wallabag-mcp
Allows managing a wallabag read-it-later library, including listing, filtering, adding, archiving, starring, deleting entries, managing tags, and creating/deleting annotations on articles.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wallabag-mcplist my unread articles from last week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: Nemo
Installation
pipx install git+https://github.com/rusty4444/wallabag-mcp.gitOr from a checkout:
python -m venv .venv
source .venv/bin/activate
pip install -e .Configuration
The server reads configuration from environment variables:
Variable | Required | Description |
| Yes | Base URL of your wallabag instance, e.g. |
| Optional | Existing OAuth access token; if set, password grant is skipped |
| Required unless access token is set | OAuth client id from wallabag's developer client page |
| Required unless access token is set | OAuth client secret |
| Required unless access token is set | wallabag username |
| Required unless access token is set | wallabag password |
| No | HTTP timeout in seconds, default |
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
Tool | Purpose |
| Verify connectivity and authentication with a tiny read-only request |
| List entries with pagination and filters |
| Fetch one entry, optionally including extracted content |
| Save a URL into wallabag |
| Update title, URL, archive/starred state, or tags |
| Mark an entry archived/read |
| Mark an entry unarchived/unread |
| Star/favourite an entry |
| Remove starred/favourite state |
| Ask wallabag to refetch/reparse the original URL |
| Delete an entry |
| List known tags |
| Add comma-separated tags to an entry |
| Delete a tag globally |
| List annotations for an entry |
| Create an annotation on quoted article text |
| Delete an annotation |
Development and validation
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
ruff check .
pytest
python scripts/live_docs_test.pylive_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.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rusty4444/wallabag-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server