docling-serve

n8n community node for docling-serve document conversion API

Package Information

Downloads: 26 weekly / 190 monthly
Latest Version: 0.0.4
Author: Hans Doebel

Available Nodes

Docling Serve icon
Docling Serve
Convert documents using Docling Serve API

Documentation

@2xdamage/n8n-nodes-docling-serve

n8n community node for integrating Docling Serve document conversion API with your workflows.

Table of Contents

Installation

Follow the installation guide in the n8n community nodes documentation.

  1. Go to Settings > Community Nodes
  2. Select Install
  3. Enter @2xdamage/n8n-nodes-docling-serve in the npm Package Name field
  4. Agree to the risks of using community nodes
  5. Select Install

Credentials

Docling Serve API

  1. Deploy a Docling Serve instance (see Docling Serve documentation)
  2. In n8n: Create new credential > Docling Serve API
  3. Enter the Base URL of your Docling Serve instance (default: http://127.0.0.1:5001)
  4. Optionally enter an API Key if your server requires authentication
  5. Save

Operations

Document

Operation Description
Convert from URL Convert a document from a URL (synchronous)
Convert from File Convert a document from binary data (synchronous)
Convert from URL (Async) Start async conversion from a URL
Convert from File (Async) Start async conversion from binary data
Get Status Get the status of an async conversion task
Get Result Get the result of a completed async conversion

Document Additional Options

  • OCR Engine: Select OCR engine for scanned documents.
  • OCR Languages: List of language codes to use with OCR. Defaults to ["en"] for EasyOCR. Note: language codes differ between engines (EasyOCR often uses 2-letter codes like en; Tesseract often uses 3-letter codes like eng).
  • Image Export Mode: Controls how images are represented in output (default: placeholder).
  • Output Formats: Which outputs to generate (default: ["md"]).
  • Document Timeout: Maximum processing time in seconds.

Chunk

Operation Description
Chunk from URL Chunk a document from a URL
Chunk from File Chunk a document from binary data

Chunk Additional Options

Chunk supports the same OCR/output-related settings as Document. Note that Output Formats and Image Export Mode mainly affect the documents field when Include Converted Document is enabled.

System

Operation Description
Health Check Check the health status of the Docling Serve instance

Compatibility

Tested with:

  • n8n Version: 2.2.3
  • Node Version: 22.11.0

Development Notes

Kill n8n Process

Add this alias to your ~/.zshrc for quick n8n process termination during development:

alias kill-n8n="kill -9 \$(lsof -ti tcp:5678 -sTCP:LISTEN)"

After adding, reload your shell: source ~/.zshrc

Publish New Release

# Bump the version
npm version patch|minor|major

# push the tag to GitHub
git push origin v1.2.3

Resources

Version History

  • 0.0.1 - Initial release

Discussion