Documentation

1. Install the extension

Add n8n AI Assistant from the Chrome Web Store. No account or signup required — it works immediately after install.

2. Connect your n8n

Official n8n.cloud and n8n.io instances work automatically — open any workflow page and the floating AI button appears.

For a self-hosted instance:

1. Click the extension icon in your toolbar to open settings
2. Under "Connect n8n Instance," paste your instance URL (e.g. https://n8n.mycompany.com)
3. Click Connect and approve Chrome's one-time permission prompt
4. Open your instance and reload the page — the floating button will appear

You can connect any number of instances, and disconnect any of them from the same settings panel. Only the exact origin you approve gets access — not <all_urls>.

3. Set up an AI provider

Generate mode needs your own API key from one provider. Pick whichever you already use:

Paste your key into the extension settings, choose it as your active provider, and pick a model. Your key is stored locally in your browser and sent directly to that provider — never to us.

4. Search mode

Open the floating button on any connected n8n page, and start typing — results update live as you type. Use the category chips to filter (AI categories are highlighted), or browse without typing anything to see popular templates.

Click any result to see a real diagram of its nodes and connections, view the raw JSON, copy it, or paste it straight into your canvas.

5. Generate mode

Switch to Generate, describe the automation you want in plain English (e.g. "send new Gmail attachments to a Google Sheet"), and your chosen AI provider builds a real, importable n8n workflow. Use Fix to auto-repair common structural issues before pasting.

6. Getting a workflow into n8n

Click Paste to n8n — it copies the workflow JSON to your clipboard and sends it to your canvas the same way n8n's own paste feature works.

If nothing appears, the JSON is already on your clipboard — just click your n8n canvas and press Ctrl+V (⌘V on Mac).

7. Light & dark theme

Click the sun/moon icon in the assistant's header to switch themes. Your choice is remembered across sessions.

8. Troubleshooting

• No floating button on my page. Make sure you're on a /workflow/ page, and for self-hosted instances, confirm you clicked Connect and approved the permission prompt.
• Generate mode says no API key configured. Open settings, pick your provider, and paste a valid key for that specific provider.
• Search is temporarily unavailable. That's a real error state — n8n's template API may be briefly unreachable. Retry in a moment.
• Still stuck? Reach us through Buy Me a Coffee.