chucky

n8n community node for Chucky - run Claude Code agents in the cloud

Package Information

Downloads: 179 weekly / 179 monthly
Latest Version: 0.1.2
Author: Chucky

Documentation

n8n-nodes-chucky

Run Claude Code (Anthropic's agentic AI) directly in your n8n workflows.

This is an n8n community node for Chucky - the platform that lets you run Claude Code agents in the cloud with full tool access (file system, bash, web browsing, and more).

Why use this?

  • Claude Code in n8n - Run the same powerful AI agent that powers Claude's computer use
  • Multi-model support - Use Claude (Sonnet, Opus, Haiku), OpenAI models, or any OpenRouter model
  • Full agent capabilities - File operations, code execution, web browsing, and custom tools
  • Background jobs - Long-running tasks that don't block your workflow
  • Structured output - Get validated JSON responses with schema enforcement

n8n is a fair-code licensed workflow automation platform.

Installation

Community Nodes (Recommended)

  1. Go to Settings > Community Nodes
  2. Select Install
  3. Enter @chucky.cloud/n8n-nodes-chucky
  4. Click Install

Manual Installation

cd ~/.n8n/nodes
npm install @chucky.cloud/n8n-nodes-chucky

Credentials

You need a Chucky API key from your Chucky Dashboard:

Field Description
API Key Your account API key (ak_live_...)

The node will automatically fetch your projects and generate authentication tokens.

Operations

Create Job

Creates a new background AI agent job.

Parameter Description
Project Select from your available projects
Message The prompt to send to the AI agent
Wait for Completion Poll until job finishes (default: true)

Model Options:

  • Model: Claude Sonnet 4.5, Opus 4.5, Haiku 3.5, or custom (OpenAI, OpenRouter)
  • System Prompt
  • Max Turns
  • Output Format (JSON Schema for structured output)

Tool Options:

  • Tools configuration
  • Allowed/Disallowed tools
  • Permission Mode

Callback Options:

  • Webhook URL for result delivery
  • HMAC signature secret

Advanced Options:

  • User ID (for billing/tracking)
  • Idempotency Key
  • TTL (delay execution)
  • AI/Compute budgets

Get Job

Get the status and result of an existing job by ID.

Cancel Job

Cancel a running job by ID.

List Jobs

List recent jobs with optional status filter.

Output

When a job completes, the node returns:

Field Description
jobId The job ID
status Job status
isSuccess Whether job succeeded
text Text result from the agent
structuredOutput Parsed JSON (when using Output Format)
totalCostUsd API cost in USD
usage Token usage stats

Structured Output

To get validated JSON output, set the Output Format field with a JSON Schema:

{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number" }
  },
  "required": ["name"]
}

The validated result will be in {{ $json.structuredOutput }}.

Resources

License

MIT

Discussion