n8n Natal Chart Node

A custom n8n node for astrological calculations using Swiss Ephemeris. Calculate natal charts, progressions, transits, astrodynes, and mundane cycle charts.

Features

• Natal Chart Calculation: Full birth chart with planets, houses, aspects
• Progressions: Major (secondary), minor, and solar arc progressions
• Transits: Current planetary transits to natal positions
• Astrodynes: Power, harmony, and discord scoring using Benjamine methodology
• Cycle Charts: Mundane astrology for historical event analysis
• Geocoding: Automatic coordinate lookup from city names

Installation

# Clone to your n8n custom nodes directory
cd ~/.n8n/custom
git clone <repo-url> n8n-nodes-natal-chart

# Install dependencies and build
cd n8n-nodes-natal-chart
npm install
npm run build

# Restart n8n

Operations

Calculate Natal Chart

Basic birth chart with planets, houses, aspects, Arabic parts, and summary.

Calculate Chart Cake (Full Analysis)

Complete analysis including:

• Natal chart
• Major and minor progressions
• Current transits
• Transit aspects to natal
• Progressed aspects
• Astrodyne scores (optional)

Calculate Transits

Current planetary positions and their aspects to natal chart.

Calculate Progressions

• Major (Secondary): 1 day = 1 year
• Minor: 1 lunar month = 1 year
• Solar Arc: Sun's movement applied to all planets

Calculate Cycle Chart (Mundane)

For historical event analysis using mundane astrology:

• Sun Cycle: Vernal Equinox (0° Aries ingress)
• Moon Cycle: New Moon/Lunation
• Planet Cycles: Declination crossing (0° N)

Geocoding

The Cycle Chart operation includes automatic geocoding:

• 60+ major capitals cached for instant lookup
• OpenStreetMap Nominatim API for other locations
• No API key required

Documentation

• Workflow Setup Guide - Complete guide to building automated workflows
• Quick Reference - Cheat sheet for expressions and configurations

Example: Historical Event Analysis Workflow

HTTP Request → Claude AI → Parse JSON → Split Items → Natal Chart (Cycle Chart) → Output

1. Fetch historical events from web source
2. Use AI to extract structured data (event name, date, location)
3. Pass to Natal Chart node with geocoding enabled
4. Analyze planetary cycles active during events

Configuration

Basic Parameters

• Birth Date: YYYY-MM-DD format
• Birth Time: HH:MM (24-hour)
• Latitude/Longitude: Decimal degrees
• Timezone Offset: Hours from UTC
• House System: Placidus, Koch, Whole Sign, etc.

Options

• Include Aspects
• Include Chiron
• Include Scores (Astrodynes)
• Primary Aspects Only

House Systems Supported

• Placidus (P)
• Koch (K)
• Whole Sign (W)
• Equal (E)
• Campanus (C)
• Regiomontanus (R)
• Porphyry (O)
• Morinus (M)

Output Structure

{
  "birthData": { "date", "time", "latitude", "longitude", "julianDay" },
  "planets": {
    "Sun": { "longitude", "sign", "house", "declination", "isRetrograde" }
  },
  "houses": { "House1": { "longitude", "sign", "keywords" } },
  "angles": { "ascendant", "midheaven", "descendant", "imumCoeli" },
  "aspects": [{ "planet1", "planet2", "kind", "orb", "isApplying" }],
  "summary": { "sunSign", "moonSign", "risingSign", "dominantElement" }
}

Requirements

• n8n (self-hosted or cloud with custom nodes)
• Node.js 18+
• Swiss Ephemeris data files (included in ephe/ directory)

Ephemeris Files

The ephe/ directory must contain:

• seas_18.se1 - Main asteroid file (includes Chiron)
• sepl_18.se1 - Planet data
• semo_18.se1 - Moon data

License

MIT

Credits

• Swiss Ephemeris for astronomical calculations
• Brotherhood of Light for astrodyne methodology
• OpenStreetMap Nominatim for geocoding