n8n-nodes-ez-chart

An n8n community node for generating charts and data visualizations using the QuickChart.io API. Designed for AI agent integration with comprehensive tool descriptions.

Features

• AI Agent Ready - usableAsTool: true with detailed descriptions for every parameter
• Auto Chart Selection - Specify your intent (compare, trend, composition, etc.) and the best chart type is selected automatically
• Multiple Data Formats - Key-value objects, number arrays, object arrays, multi-series, raw JSON
• 6 Style Presets - Minimal, Business, Dark, Vibrant, Accessible, Print
• Multiple Output Formats - PNG, SVG, JPG, WebP
• Self-Hosted Support - Works with custom QuickChart instances via configurable base URL

Supported Chart Types

| Chart Type | Best For | |------------|----------| | Bar (Vertical) | Comparing values across categories | | Bar (Horizontal) | Long labels, rankings | | Line | Trends over time | | Area | Volume over time | | Pie | Proportions (2-7 categories) | | Doughnut | Modern alternative to pie | | Radar | Multi-dimensional comparison | | Polar Area | Equal-angle varying radius | | Scatter | Relationships between variables |

Operations

Create Chart (Simple)

Provide data and a visualization intent. The node automatically selects the best chart type.

Intents:

• compare - Compare values across categories (bar, horizontal bar)
• trend - Show changes over time (line, area)
• composition - Parts of a whole (pie, doughnut)
• distribution - Data distribution (bar)
• relationship - Correlation between variables (scatter)
• progress - Progress toward a goal (gauge, progress bar)

Create Chart (Advanced)

Full control over chart type, labels, datasets, and styling.

Analyze Data

Get chart type recommendations with confidence scores before creating a chart.

Data Formats

// Key-Value Object
{"January": 100, "February": 150, "March": 120}

// Array of Numbers
[10, 20, 30, 40, 50]

// Array of Objects
[{"label": "Product A", "value": 30}, {"label": "Product B", "value": 45}]

// Multi-Series
{"Revenue": [100, 150, 120], "Costs": [80, 90, 85]}

Style Presets

| Preset | Description | |--------|-------------| | minimal | Clean, modern look with subtle colors | | business | Professional with data labels, blue tones | | dark | Dark background with bright colors | | vibrant | Colorful and eye-catching | | accessible | WCAG compliant, high contrast | | print | Grayscale-friendly |

Installation

In n8n (Community Nodes)

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-ez-chart
4. Agree to the risks and install

Manual Installation

cd ~/.n8n/nodes
npm install n8n-nodes-ez-chart

Restart n8n after installation.

Credentials (Optional)

The node works without credentials using the free QuickChart.io API. To configure:

• Base URL - Custom QuickChart instance URL (default: https://quickchart.io)
• API Key - Optional key for QuickChart professional accounts

Output

The node returns:

{
  "success": true,
  "url": "https://quickchart.io/chart?c=...",
  "width": 600,
  "height": 400,
  "format": "png",
  "chartType": "bar",
  "intent": "compare",
  "style": "minimal"
}

With Return Base64 option enabled:

{
  "success": true,
  "base64": "iVBORw0KGgo...",
  "dataUri": "data:image/png;base64,iVBORw0KGgo...",
  "mimeType": "image/png"
}

AI Agent Usage

This node is designed for use with n8n's AI Agent node. The usableAsTool: true flag makes it available as a tool that AI agents can invoke to generate charts during conversations.

Example agent prompt:

"Create a bar chart comparing Q1-Q4 sales: Q1=100, Q2=150, Q3=120, Q4=200. Use a business style."

Development

# Install dependencies
npm install

# Build
npm run build

# Development with watch
npm run dev

# Lint
npm run lint

License

MIT