kitsu

n8n community node for Kitsu (CGWire) — full REST API access for animation/VFX production management

Package Information

Released: 6 mo ago
Downloads: 16 weekly / 55 monthly
Latest Version: 0.1.2
Author: Aiacos

Available Nodes

Kitsu icon
Kitsu
Interact with the Kitsu/CGWire production management API (Zou)

Documentation

n8n-nodes-kitsu

Community node for n8n that provides full access to the Kitsu / CGWire production management API (powered by Zou).

n8n
License
Kitsu API

What is Kitsu?

Kitsu is an open-source production tracking platform for animation and VFX studios, developed by CGWire. It allows studios to track tasks, review assets and shots, manage teams and deadlines — all via a REST API called Zou.

This n8n node exposes the entire Zou API as native n8n operations, enabling you to build automation workflows, AI agents, and integrations around your production pipeline.

Features

Full CRUD access to all main Kitsu resources:

Resource Operations
Project Get, Get All, Create, Update, Delete
Shot Get, Get All, Create, Update, Delete
Asset Get, Get All, Create, Update, Delete
Task Get, Get All, Create, Update, Delete
Sequence Get, Get All, Create, Update, Delete
Episode Get, Get All, Create, Update, Delete
Person Get, Get All, Create, Update, Delete
Task Status Get, Get All, Create, Update, Delete
Task Type Get, Get All, Create, Update, Delete
Comment Get All (for Task), Create, Update, Delete
Preview File Get, Get All (for Task)
Custom Action Execute any endpoint (GET / POST / PUT / PATCH / DELETE)

Authentication

JWT-based. The node logs in automatically at execution time using your email and password — no manual token management required.

Installation

Requires n8n self-hosted (v1.0+). Community nodes are not available on n8n Cloud.

Metodo 1 — Interfaccia n8n (consigliato)

  1. Vai su Settings → Community Nodes
  2. Clicca Install a community node
  3. Inserisci il nome del pacchetto:
    n8n-nodes-kitsu
  4. Spunta la conferma e clicca Install

n8n installa il nodo automaticamente — nessun riavvio necessario.

Metodo 2 — npm da terminale

npm install --prefix ~/.n8n n8n-nodes-kitsu
n8n start

Metodo 3 — Docker

FROM n8nio/n8n:latest
USER root
RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-kitsu
USER node

Oppure via docker exec su un container già avviato:

docker exec -it <container_name> npm install --prefix /home/node/.n8n n8n-nodes-kitsu
docker restart <container_name>

Credentials Setup

  1. In n8n go to Credentials → New → Kitsu API
  2. Fill in:
    • Kitsu Host URL — e.g. https://kitsu.yourstudio.com (no trailing slash)
    • Email — your Kitsu account email
    • Password — your Kitsu account password

Usage Examples

See the examples/ folder for ready-to-import n8n workflow JSON files:

File Description
workflow-1-ai-comment-analysis.json AI reads task comments and posts a summary back to Kitsu
workflow-2-ai-task-supervisor.json AI agent monitors tasks in Review and takes automatic actions
workflow-3-chatbot-production.json Chat-based AI assistant with full Kitsu access as tools

Import any workflow via n8n → Workflows → Import from file.

Custom Action

The Custom Action resource lets you call any Zou endpoint not yet covered by the built-in operations:

  • Set HTTP method, path, query string and JSON body freely
  • Useful for: /actions/projects/{id}/set-preview, /export/projects/all, /data/entities/{id}/casting, etc.

Example path: /actions/tasks/{task_id}/set-main-preview

Environment Variables (for workflows)

The example workflows use these n8n Variables (Settings → Variables):

Variable Description
KITSU_PROJECT_ID UUID of your default project
KITSU_STATUS_REVIEW_ID UUID of the "Review" task status
KITSU_DEFAULT_SUPERVISOR_ID UUID of the default supervisor person

Project Structure

n8n-nodes-kitsu/
├── credentials/
│   └── KitsuApi.credentials.ts     # Credential type definition
├── nodes/
│   └── Kitsu/
│       ├── Kitsu.node.ts           # Main node implementation
│       └── kitsu.svg               # Node icon
├── examples/
│   ├── workflow-1-ai-comment-analysis.json
│   ├── workflow-2-ai-task-supervisor.json
│   └── workflow-3-chatbot-production.json
├── dist/                           # Compiled JS (auto-generated)
├── index.ts                        # Package entry point
├── package.json
└── tsconfig.json

Development

# Install dependencies
npm install

# Watch mode (recompiles on save)
npm run dev

# Full build
npm run build

# Lint
npm run lint

Links

License

MIT © Aiacos

Discussion