n8n-nodes-neon

library0.1.0jsnpmunverified

An n8n community node that connects to Neon, a serverless PostgreSQL database with instant branching and automatic scale-to-zero. Current stable version: 0.1.0. This node provides CRUD operations (INSERT, SELECT, UPDATE, DELETE), custom SQL query execution with parameter binding, schema introspection for dynamic table and column discovery, and multiple execution modes (Single, Transaction, Independent). SSL connections are enforced for security. Compatible with n8n 1.0.0+. Developed by Danish Aftab as a community node, not officially maintained by Neon or n8n. Release cadence is irregular; check GitHub for updates. Key differentiator: lets n8n workflows interact directly with Neon's serverless Postgres, leveraging its branching and autoscaling features.

database

npm install n8n-nodes-neon

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · N8N-NODES-NEON

n8n-nodes-neon

databasejavascriptv0.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Neon

✓ import { Neon } from 'n8n-nodes-neon'

✗ const Neon = require('n8n-nodes-neon')

This is a named export. ESM import is recommended; CommonJS require may work in n8n environments due to transpilation, but the package exposes ESM.

NeonV1

✓ import { NeonV1 } from 'n8n-nodes-neon'

Older version alias; use 'Neon' for the current version. Included for backward compatibility.

INeonCredentials

✓ import type { INeonCredentials } from 'n8n-nodes-neon'

✗ import { INeonCredentials } from 'n8n-nodes-neon'

This is a TypeScript type; use `import type` to avoid runtime inclusion. Available in .d.ts.

Shows how to import the Neon node and configure credentials for use in an n8n workflow, with environment variables for sensitive data.

import { Neon } from 'n8n-nodes-neon'; // In n8n workflow, add Neon node, configure credentials: const credentials = { host: process.env.NEON_HOST ?? 'ep-xxx-pooler.region.aws.neon.tech', port: 5432, database: process.env.NEON_DB ?? 'mydb', user: process.env.NEON_USER ?? 'user', password: process.env.NEON_PASSWORD ?? '', ssl: true }; // Example: SELECT rows // In n8n editor, set Operation: SELECT // Table: 'users' // Return fields: '*' // This node automatically introspects schema and provides dynamic dropdowns.

Debug

Known issues

breakingNode requires n8n version >=1.0.0. Older versions are not supported.

fix

Upgrade n8n to version 1.0.0 or higher.

affects: <1.0.0

breakingSSL must be enabled. The node forces SSL connections and will fail if disabled.

fix

Set 'ssl' to true in credentials or ensure your Neon connection string uses sslmode=require.

affects: >=0.1.0

deprecatedThe 'NeonV1' import is deprecated; use 'Neon' instead.

fix

Replace import { NeonV1 } with import { Neon }.

affects: >=0.1.0

gotchaNode.js 20+ is required (enforced by n8n). Running on older Node.js versions will cause runtime errors.

fix

Ensure your environment uses Node.js >=20.15 as specified in engines.

affects: >=0.1.0

gotchaThis is a community node; not officially maintained by Neon or n8n. Use with caution in production.

fix

Review the GitHub repository for issues and contributions.

affects: >=0.1.0

Errors

Common errors & fixes

Cannot find module 'n8n-nodes-neon'

Package not installed or n8n cannot find it in community nodes directory.

fix

Install via n8n UI: Settings > Community Nodes > Install > enter 'n8n-nodes-neon'.

SSL connection required

SSL is disabled in credentials but Neon requires SSL.

fix

In node credentials, set SSL toggle to 'true' or use a connection string with sslmode=require.

Connection refused: connect ECONNREFUSED

Incorrect host or port, or Neon project not active (paused after inactivity).

fix

Verify host (e.g., ep-xxx-pooler.region.aws.neon.tech) and port (5432). If paused, run any query via Neon console to wake up.

relation "users" does not exist

Specified table does not exist in the database/schema.

fix

Use schema introspection to select existing tables, or create the table first. Check that the schema name is correct (default 'public').

Upgrade

Version history

0.1.0latest on npm

Audit

Dependencies

n8n-workflowrequiredRequired to run any n8n community node; provides base classes and utilities.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/danishaft/Neon-db-node ↗

packagen8n-nodes-neon ↗

homepagehttps://n8n.io ↗