n8n-nodes-komga

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

Komga is a free and open source media server for your comics, mangas, BDs and magazines. This node provides full integration with the Komga API, allowing you to manage libraries, series, books, collections, and readlists through n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Resources
Version History

Installation

Follow the installation guide in the n8n community nodes documentation.

In n8n, go to Settings → Community Nodes → Install and enter:

n8n-nodes-komga

Or install via npm in your n8n installation directory:

npm install n8n-nodes-komga

Operations

The Komga node supports the following resources and operations:

Library

• Create - Create a new library
• Delete - Delete a library
• Get - Get the data of a single library
• List - List all libraries
• Update - Update a library

Series

• Analyze - Trigger analysis for a series (requires ADMIN role)
• Get - Get the data of a single series by ID
• Get Collections - List all collections for a series
• Get Thumbnail - Get the poster image for a series
• List - List series (with filtering options)
• List Alphabetical Groups - List series grouped by first character
• List Latest - List recently added or updated series
• List New - List newly added series
• List Release Dates - List release dates for series
• List Thumbnails - List all poster images for a series
• List Updated - List recently updated series (not newly added)
• Mark as Read - Mark all books in series as read
• Mark as Unread - Mark all books in series as unread
• Delete File - Delete all book files for a series (requires ADMIN role)
• Delete Thumbnail - Delete a specific thumbnail for a series (requires ADMIN role)
• Get Thumbnail by ID - Get a specific thumbnail image by ID
• Refresh Metadata - Trigger metadata refresh for a series (requires ADMIN role)
• Select Thumbnail - Mark a thumbnail as selected for a series (requires ADMIN role)
• Update Metadata - Update metadata for a series (requires ADMIN role)
• Upload Thumbnail - Upload a new poster image for a series (requires ADMIN role)

Book

• Get - Get the data of a single book
• List - List books (with filtering options)

Collection

• Create - Create a new collection
• Delete - Delete a collection
• Get - Get the data of a single collection
• List - List all collections
• Update - Update a collection

Readlist

• Create - Create a new readlist
• Delete - Delete a readlist
• Get - Get the data of a single readlist
• List - List all readlists
• Update - Update a readlist

Credentials

To use this node, you need to configure Komga API credentials. You can authenticate using one of two methods:

API Key Authentication

1. Log in to your Komga instance
2. Go to Settings → API Keys
3. Create a new API key or use an existing one
4. In n8n, select API Key as the authentication method
5. Enter your Komga instance base URL (e.g., https://komga.example.com)
6. Enter your API key

Basic Authentication

1. In n8n, select Basic Auth as the authentication method
2. Enter your Komga instance base URL
3. Enter your Komga username and password

Note: The default base URL is set to https://demo.komga.org for testing purposes. Make sure to update this with your own Komga instance URL.

Compatibility

• Minimum n8n version: 1.0.0
• Komga API version: v1 (compatible with Komga 0.160.0+)

This node has been tested with:

• n8n 1.0.0 and later
• Komga 0.160.0 and later

Usage

Example Workflows

Automate Library Management:

• Create a library when a new folder is detected
• Update library metadata from external sources
• Monitor library health and send notifications

Series and Book Management:

• List all series in a library
• Get book details for processing
• Filter books by metadata or status

Collection and Readlist Automation:

• Create collections based on tags or metadata
• Automatically generate readlists from external sources
• Update collection metadata in bulk

Tips

• Use the List operations to retrieve all items, then filter or process them in subsequent nodes
• The node supports dynamic expressions, so you can use data from previous nodes in your workflow
• For large datasets, consider using pagination options available in List operations

Resources

• n8n community nodes documentation
• Komga Documentation
• Komga API Documentation
• n8n Node Development Guide

Version History

1.1.0

• Added extensive Series operations:
  • Analyze series
  • Get Collections for a series
  • Get/List/Upload/Delete/Select Thumbnails
  • List Latest, New, Updated series
  • List Alphabetical Groups
  • List Release Dates
  • Mark as Read/Unread
  • Delete series files
  • Refresh and Update Metadata

1.0.6

• Fix URL issues

1.0.5

• Remove Publish Workflow

1.0.4

• Fix a PreSend issue

1.0.2

• Initial commit
• Komga API node
• Update PreSend method name to make it easier to understand the issue

1.0.0

• Initial release
• Support for Library, Series, Book, Collection, and Readlist resources
• API Key and Basic Auth authentication methods
• Full CRUD operations for Library, Collection, and Readlist
• List and Get operations for Series and Book

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

---

Author: Sylvain Cau
Repository: https://github.com/AshDevFr/n8n-nodes-komga