n8n-nodes-kitsu

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

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

• Kitsu API Docs
• Zou GitHub
• Gazu Python Client
• n8n Community Nodes Docs

License

MIT © Aiacos