@keboola/n8n-nodes-keboola
v0.1.1
Published
n8n node to interact with Keboola Storage APIs & MCP Server
Downloads
83
Readme
n8n Nodes – Keboola Integration
This is an n8n community node that integrates Keboola with your n8n workflows, so you can automate data pipelines, upload and download tables, and connect Keboola to hundreds of other services through n8n.
Keboola is a data platform for building and running data pipelines, while n8n is a fair-code licensed workflow automation tool. Together, they allow you to orchestrate data flows end-to-end with minimal effort.
Table of Contents
- Installation (self-hosted)
- Installation for development and contributing
- Operations
- Credentials
- Compatibility
- Usage
- Resources
- Release
- Version History
- Troubleshooting
Installation (self-hosted)
To install the Keboola community node directly from the n8n Editor UI:
- Open your n8n instance.
- Go to Settings → Community Nodes.
- Select Install a community node.
- Enter the npm package name:
@keboola/n8n-nodes-keboola - Accept the community node disclaimer and confirm installation.
The Keboola node is now available in your workflows.
Installation for development and contributing
If you want to contribute to this project, you can link the node to your local n8n instance.
Prerequisites
- Node.js (recommended v20+)
Steps
- Initialize n8n locally
Install and start n8n (if not already installed):
npm install -g n8n
n8n startThis will create the ~/.n8n directory.
- Clone and build the node
git clone [email protected]:keboola/n8n-nodes-keboola.git # or https://github.com/keboola/n8n-nodes-keboola.git
cd n8n-nodes-keboola
npm install
npm run build- Link the custom node to n8n
mkdir -p ~/.n8n/custom
ln -s /full/path/to/n8n-nodes-keboola ~/.n8n/custom/n8n-nodes-keboola- Restart n8n
n8n start- Making changes
If you modify the node, rebuild and restart:
npm run build
n8n startOperations
The Keboola node currently supports three types of operations:
- Data Export
Extracts data from a Keboola table into your n8n workflow. - Parameters: Credential, Table ID
- Data Import
Uploads data from your workflow into a Keboola table. - Parameters: Bucket Stage, Bucket Name, Table Name, Primary Key(s), Import Mode
- Custom API Call
For advanced use cases, you can call any Keboola Storage API endpoint directly.
Credentials
The node uses API Key authentication.
When creating a credential in n8n, select your Keboola stack region:
https://connection.keboola.com(Stack: AWS, Region: us-east-1)https://connection.eu-central-1.keboola.com(Stack: AWS, Region: eu-central-1)https://connection.north-europe.azure.keboola.com(Stack: Azure, Region: north-europe)https://connection.us-east4.gcp.keboola.com(Stack: US East, Region: us-east4)
Then provide your Keboola Storage API Token (create under Project Settings → API Tokens in Keboola).
Compatibility
This node has been tested with n8n version 1.57.0 and newer.
Usage
- Create a new workflow in n8n.
- Add the Keboola node.
- Select an operation:
- Data Export to pull a table.
- Data Import to write into Keboola.
- Custom API Call for advanced use.
- Configure the parameters.
- Connect with other nodes (e.g., Google Sheets, Slack, HTTP).
- Execute the workflow.
Resources
- Keboola API Documentation
- n8n Documentation
- n8n Community Nodes Guide
- n8n Keboola Documentation
- NPM Package
- GitHub Repository
Release
This project uses GitHub Actions to publish releases to npm. To create a release:
- Ensure
mainis up to date. - Bump the version in
package.jsonaccording to semver. - Commit and push.
- Create a GitHub Release with the new version tag (e.g.,
v0.2.0).
The CI workflow will build and test the package. The publishing is currently done manually as the policies related to company wide npm token policies has been changed.
Version History
See Releases.
Troubleshooting
- Authentication errors: Verify your API token and stack region are correct.
- Operation errors: Double-check bucket names, table IDs, or job IDs.
- Node not available: Confirm the Keboola node is installed from the Community Nodes registry. Currently only self-hosted n8n is supported.
For additional help, open an issue in this repo or contact Keboola Support.
