Resources · n8n integration

n8n Ollama nodeConfigure Ollama in n8n.

The n8n Ollama node talks to the models running on your own Ollama server. It ships 2 operations, one for text and one for images, both built on a Model selector and a shared Options collection of 25 sampling settings. Useful when the data cannot leave the building.

Verified Trustpilot reviews · AI, automation & growth agency

Why automate

What does the n8n Ollama node do in a workflow?

It sends a prompt to a model hosted on an Ollama server and returns the model's answer as workflow data. The node runs like any other action node, once per incoming item, and has no sub-node ports, so nothing gets plugged underneath it. Two resources split the work: Text sends a conversation, Image takes pictures and answers questions about them.

Start with the classifier case. A support form lands in a workflow, the Text resource gets a System Message that spells out the categories, Temperature goes low so the output stops drifting, and the category comes back ready to route. Set Output Format to json and the answer parses without a cleanup step, which matters when the next node writes to Google Sheets.

Second case, document images. A scanned delivery note arrives as a binary file, which is a file attached to the item rather than text. The Image resource reads it through Input Data Field Name(s), the Text Input field carries the question, and the extracted reference goes into a reply drafted by Gmail. Hosted vision models such as OpenAI do the same job, but here the image never leaves your network.

Third case, bulk rewriting. A list of product descriptions runs through the node item by item, Max Tokens caps the length, and Seed makes a rerun produce the same text for the same prompt, so a diff between two runs means something.

When to pick something else. This node answers a prompt and stops. It holds no conversation history of its own, it calls no tools, and it makes no decisions about what to do next, so anything that needs memory or tool calls belongs to the AI Agent node instead. The node also cannot pull a model down for you: the model has to already exist on the Ollama server you point at.

Known limits. The Options collection exposes 25 settings, several of them tied to the machine rather than the prompt (Number of GPUs, Number of CPU Threads, Low VRAM Mode), which is a fair warning: a local model is only as fast as the hardware under it. Thinking only applies to models that support it, and Simplify Output is the fastest way to stop reading through a raw API envelope. If you are still choosing a platform, the n8n review covers the self-hosting side in more detail.

Connect

What do you need to connect before the node runs?

  1. 01

    Create the Ollama credential

    Open the Credentials menu in n8n and add an Ollama credential. It asks for a Base URL, defaulting to http://localhost:11434, and an optional API Key for a proxy expecting a Bearer token. A credential is the stored connection n8n reuses instead of asking again in every workflow, so this step happens once.

  2. 02

    Attach it to the node

    Drop the Ollama node on the canvas and select that credential at the top of its panel. The same credential serves both resources, so a workflow that classifies text and another that reads images share one entry and one place to fix things when the server moves.

  3. 03

    Pick the model

    Fill Model, the only required field on both operations. It is a resource locator, meaning you either choose an entry from the list n8n loads or type the identifier yourself, which is what you do when the model name comes from an earlier node as {{ $json.model }}.

Actions

What can the Ollama node do?

The Ollama node exposes 2 operations across 2 resources. For each one: the node as you configure it in n8n, the required fields, and our field notes.

Resources × operations matrix
ResourceAnalyze ImageMessage a Model
Image
Text

Image

1 operation
01

Analyze image

image.analyze

What you see in n8n

Notes & use cases

Feeds one or more images to a vision-capable model and returns its answer to a question you write. Good for reading what is printed on a document rather than describing a photo.

Key parameters

  • Model: required, the vision model to call, picked from the list or typed in.
  • Input Type: binary for files carried by the item, url for images already online.
  • Input Data Field Name(s): the binary field holding the image, often data, several names separated by commas.
  • URL(s): the image addresses when you chose url, comma separated.
  • Text Input: the question asked about the image.
Use cases
pull the invoice number off a scanned page, then send it on to Slack for approval.

Text

1 operation
02

Message a model

text.message

What you see in n8n

Notes & use cases

Sends a conversation to the model and returns the reply. Nothing is remembered between executions, so the whole exchange you want the model to see travels in the request.

Key parameters

  • Model: required, the text model that answers.
  • Messages: the list of turns, each one a Content string and a Role, user for the question and assistant to replay an earlier answer as history.
  • System Message: the standing instruction that frames every turn.
  • Simplify Output: on, you get the answer alone instead of the full response payload.
Use cases
turn a raw meeting note into a short summary before it reaches the team channel.
Need help

Need help automating Ollama with n8n?

A person reads every message.

FAQ

Ollama and n8n, common questions

01Is the Ollama node included in n8n?
Yes. It belongs to the n8n AI package, shipped with n8n itself, so there is nothing to install and nothing extra to pay on the n8n side. It works the same on n8n Cloud, the hosted offer run by n8n, and on a self-hosted instance running the Community Edition under the Sustainable Use licence, installed through Docker or npm. A workflow built in one place behaves the same in the other. What you do pay for is the machine running Ollama, since the models run on your own hardware rather than on a provider's API.
02What do you need for the n8n Ollama node to work?
A credential and a model. The credential is created once from the Credentials menu in n8n and reused across every workflow, so you set it up on the first node and pick it from a list afterward. Then each operation needs its Model field filled, because it is the only required parameter on both Analyze image and Message a model. The model itself has to exist on the Ollama server the credential points to. The node does not download or install anything for you.
03What are the limits of the Ollama node?
The node exposes 2 operations, one per resource, and that is the whole surface: text conversations and image questions. There is no memory between executions, no tool calling, and no ports to plug sub-nodes into, since it runs as a plain action node on each incoming item. Version 1 is the version described here, and an older workflow may show fewer options. Several of the 25 Options fields tune the machine rather than the prompt, which is a reminder that speed depends on the hardware you run.
04Which operation should you start with?
Start with Message a model. It has the shortest path to a result: pick the Model, add one message with a user Role, run the node, read the reply. Once that works, adding a System Message and lowering Temperature is enough to turn it into a classifier you can trust in a routing branch. Analyze image is the one to reach for when the input is a picture or a scan, and it needs a model that handles vision, otherwise the answer comes back useless.
05n8n or Make for running local models?
It depends on where the data has to stay. n8n can be self-hosted, so the workflow and the Ollama server can live on the same private network and nothing leaves it. Make is hosted only, with no self-hosting option, and it bills by operation, which changes how a loop over a few thousand items looks on your invoice. Make tends to be easier to read on a short linear scenario, while n8n's visual logic takes branches and code in its stride. For local models, the self-hosting option is usually the deciding factor.
Hack'celeration Lab

Get our weekly integration tips.

No spam. Unsubscribe anytime.