n8n-nodes-wallabag

This is an n8n community node. It lets you use Wallabag in your n8n workflows.

Wallabag is a self-hosted read-it-later application that allows you to save web articles and read them later. This node provides comprehensive integration with the Wallabag API, enabling you to automate article saving, tagging, searching, and annotation workflows.

n8n is a fair-code licensed workflow automation platform.

Installation •
Operations •
Credentials •
Compatibility •
Usage •
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Node Installation

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter n8n-nodes-wallabag in the Enter npm package name field
4. Agree to the risks and select Install

After installation, the Wallabag node will be available in your node palette.

Operations

This node supports 4 resources with 17 total operations:

Annotation

• Create: Add a note or highlight to an entry
• Delete: Remove an annotation
• Get: Retrieve all annotations for an entry
• Update: Edit an existing annotation

Entry

• Create: Save a new URL to Wallabag
• Delete: Remove an entry
• Exists: Check if a URL is already saved
• Export: Download entry in various formats (PDF, EPUB, MOBI, TXT, JSON, XML)
• Get: Retrieve a single entry by ID
• Get Many: List entries with filtering and pagination
• Manage Tags: Add, remove, or list tags on an entry
• Reload: Refresh entry content from the original URL
• Update: Modify entry properties (title, tags, archive status, etc.)

Search

• Search: Find entries by search term with pagination

Tag

• Delete: Remove a tag globally by ID
• Delete by Label: Remove tag(s) by name
• Get Many: List all tags

Credentials

This node uses OAuth2 authentication with the password grant type. You'll need to configure credentials for your Wallabag instance.

Prerequisites

1. A Wallabag account (self-hosted or hosted service like wallabag.it)
2. API client credentials from your Wallabag instance

Setting up OAuth2 Credentials

Step 1: Create an OAuth Client in Wallabag

1. Log in to your Wallabag instance
2. Go to Settings > API clients management or navigate to https://your-wallabag-instance.com/developer/client/create
3. Create a new client:
   • Client name: n8n (or any name you prefer)
   • Redirect URI: http://localhost (this can be any valid URL for password grant)
4. Save and note your Client ID and Client Secret

Step 2: Configure Credentials in n8n

1. In n8n, create a new Wallabag OAuth2 API credential
2. Fill in the following fields:
   • Wallabag Instance URL: Your Wallabag URL (e.g., https://app.wallabag.it or https://your-wallabag.com)
   • Access Token URL: Your instance URL + /oauth/v2/token (e.g., https://app.wallabag.it/oauth/v2/token)
   • Client ID: From Step 1
   • Client Secret: From Step 1
   • Username: Your Wallabag username
   • Password: Your Wallabag password
3. Save the credential

The node will automatically handle token acquisition and refresh.

Self-Hosted Instances

This node fully supports self-hosted Wallabag instances. Simply enter your instance URL in the credential configuration, and all API calls will be directed to your server.

Compatibility

• Minimum n8n version: 1.0.0
• Tested against: n8n v1.x
• Wallabag API: Compatible with Wallabag v2.x API

Usage

Example Workflows

Save Articles from RSS Feed

1. RSS Read node → Fetch articles from feed
2. Wallabag node (Entry: Exists) → Check if already saved
3. IF node → If not exists
4. Wallabag node (Entry: Create) → Save to Wallabag with tags

Daily Digest of Unread Articles

1. Schedule Trigger → Daily at 9 AM
2. Wallabag node (Entry: Get Many) → Filter: archive=0, starred=1
3. Format data → Create email content
4. Gmail node → Send digest email

Archive Old Read Articles

1. Schedule Trigger → Weekly
2. Wallabag node (Entry: Get Many) → Get archived entries
3. Filter by date → Older than 6 months
4. Wallabag node (Entry: Delete) → Remove old entries

Research Workflow with Annotations

1. Wallabag node (Entry: Create) → Save research article
2. Wallabag node (Annotation: Create) → Add research notes
3. Wallabag node (Entry: Update) → Tag as "research"
4. Wallabag node (Entry: Export) → Export as PDF for archival

Tips

• Use the Exists operation before creating entries to avoid duplicates
• The Get Many operation supports extensive filtering (archive status, starred, tags, date range, domain)
• Export operation supports multiple formats - perfect for creating reading backups
• Manage Tags allows granular tag control without replacing all tags
• Search is useful for finding specific content across your saved articles

Resources

• n8n community nodes documentation
• Wallabag official website
• Wallabag API documentation
• Wallabag OAuth2 guide

Version History

0.2.3 (Upadte Logo for credential section)

• ✅ Update Logo for credentials section

0.2.2 (Upadte Logo)

• ✅ Update Logo and documentation

0.2.1 (Fix Auth)

• ✅ Fixing Wallabag Auth Token fetching

0.1.0 (Initial Release)

• ✅ Complete Wallabag API integration
• ✅ 4 resources: Annotation, Entry, Search, Tag
• ✅ 17 operations covering full API functionality
• ✅ OAuth2 password grant authentication
• ✅ Self-hosted instance support
• ✅ Binary data handling for exports (PDF, EPUB, MOBI)
• ✅ Automatic pagination for list operations
• ✅ Comprehensive filtering and search capabilities