> ## 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.