> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memmachine.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
> Equip your n8n workflows with persistent, AI-native memory nodes
The MemMachine integration for **n8n** allows you to build sophisticated AI agents that remember users across sessions\[cite: 1]. By using the MemMachine community nodes, you can store interactions, retrieve deep context, and trace memory operations directly within your automation canvas\[cite: 2].
## Overview
This integration provides two specialized nodes:
* **MemMachine Manager:** Store messages and "Enrich" your agent prompts with semantic context\[cite: 3].
* **MemMachine AI Memory:** A native memory node that plugs directly into n8n's **AI Agent** node\[cite: 4].
## Start n8n
To start a simple n8n container run the upstream docker container as described in the official docs:
```bash theme={null}
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="Europe/Berlin" \
-e TZ="Europe/Berlin" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-e N8N_RUNNERS_ENABLED=true \
-v n8n_data:/home/node/.n8n \
docker.n8n.io/n8nio/n8n
```
### With Tracing
If you want to visualize the memory interactions you might want to use the `docker-compose` file in the github repository.
```bash theme={null}
wget -q [https://raw.githubusercontent.com/MemMachine/n8n-nodes-memmachine/refs/heads/main/docker-compose.yml](https://raw.githubusercontent.com/MemMachine/n8n-nodes-memmachine/refs/heads/main/docker-compose.yml)
docker-compose up -d
```
Either way, after one of the commands finished, you are able to open your n8n instance.
Open [localhost:5678/](http://localhost:5678/):
1. Fill out a sign-up form.
2. Skip the customization and click `Get Started`.
3. Skip the offer page with `Skip`.
If you are using a self-hosted n8n instance:
1. Navigate to **Settings > Community Nodes**.
2. Click **Install a community node**.
3. Enter the package name: `@memmachine/n8n-nodes-memmachine`
4. Acknowledge the risk and click **Install**.
When you add a MemMachine node, you will be prompted to create credentials. You will need your **API Key** from the MemMachine Dashboard.
## MemMachine Manager Node
The Manager node is used for manual memory operations at any point in your workflow.
### Connect MemMachine
To use the node you'll need to configure a connection. In case you are running MemMachine on the same machine as a docker container use this endpoint:
[http://host.docker.internal:8080/v2/api](http://host.docker.internal:8080/v2/api)
### Action: Store a message
Saves a specific content string to long-term memory.
| **Parameter** | **Type** | **Description** |
| --------------------- | ------------ | ----------------------------------------------------------------- |
| **orgId / projectId** | String | **Required.** Your unique organization and project identifiers. |
| **types** | multiOptions | **Required.** Memory types to use (episodic, semantic). |
| **producer** | String | **Required.** Who created this message (e.g., "Agent" or "User"). |
| **producedFor** | String | **Required.** Intended recipient of the message. |
| **episodeContent** | String | **Required.** The actual message text to store. |
| **episodeType** | Options | `none` (default) or `message`. |
| **metadata** | JSON | Additional metadata to associate with the message. |
| **sessionId** | String | **Required.** Unique session identifier. |
| **groupId** | String | Unique group identifier (defaults to `default`). |
| **agentId / userId** | String | **Required.** Identifiers for the specific AI agent and user. |
### Action: Enrich with context
Retrieves historical context to inject into an LLM prompt.
| **Parameter** | **Type** | **Default** | **Description** |
| --------------------- | ------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **orgId / projectId** | String | - | **Required.** Unique organization and project identifiers. |
| **types** | multiOptions | - | **Required.** Memory types to use (episodic, semantic). |
| **query** | String | - | **Required.** Natural language query for semantic search. |
| **limit** | Number | 50 | Maximum number of memory results to return. |
| **scoreThreshold** | Number | - | Minimum relevance score required to include a memory. |
| **filter** | String | - | Filter expression to refine memory search results. Prefix user metadata fields with `m.` / `metadata.` (for example `m.user_id = '123'`). String literals must be single-quoted. Unknown or misspelled user metadata fields return a 400 error. |
| **expandContext** | Number | 0 | Number of extra episodes to include for context. |
| **sessionId** | String | - | **Required.** Unique session identifier. |
| **groupId** | String | `default` | Unique group identifier. |
| **agentId / userId** | String | - | **Required.** Identifiers for the specific AI agent and user. |
| **enableTemplate** | Boolean | `true` | Renders a formatted context string using a template. |
| **contextTemplate** | String | `default template` | Markdown template for formatting. |
## MemMachine AI Memory Node
Connect this node directly to the **Memory** input of a native n8n **AI Agent** node.
| **Parameter** | **Type** | **Default** | **Description** |
| ------------------------- | -------- | ------------------ | --------------------------------------------------------------- |
| **orgId / projectId** | String | - | **Required.** Your unique organization and project identifiers. |
| **contextWindowLength** | Number | 10 | Max recent messages to include in chat history. |
| **enableMemoryTemplate** | Boolean | `false` | Whether to wrap history in a formatted template. |
| **historyCount** | Number | 5 | Number of episodic memories to include in the template. |
| **shortTermCount** | Number | 10 | Number of short-term memories to include. |
| **memoryContextTemplate** | String | `default template` | Markdown template for formatting. |
`default template` refers to the system's built-in memory context template. Users may override it with a custom template.
## Video Walkthrough
Seeing is believing. Check out this practical demonstration of setting up MemMachine nodes within n8n to create persistent AI agents.
## Observability & Tracing
MemMachine nodes support native **OTLP Tracing** for debugging complex agent logic.
| **Parameter** | **Type** | **Description** |
| ---------------------- | -------- | -------------------------------------------------------- |
| **tracingEnabled** | Boolean | Set to `true` to enable operation tracing. |
| **traceVerbosity** | Options | `minimal`, `normal`, or `verbose`. |
| **exportToJaeger** | Boolean | If `true`, sends traces to your Jaeger instance. |
| **jaegerOtlpEndpoint** | String | The endpoint URL (e.g., `http://jaeger:4318/v1/traces`). |
When using the **AI Memory Node**, ensure your `agentId` and `userId` are passed consistently across the workflow to ensure the agent's "recognition" of the user remains persistent.