{"_id":"@amaralkarl/n8n-nodes-mem0","_rev":"2-c0ea562a5dbf2b6a04364c71bad6f93c","name":"@amaralkarl/n8n-nodes-mem0","dist-tags":{"latest":"2.0.1"},"versions":{"2.0.0":{"name":"@amaralkarl/n8n-nodes-mem0","version":"2.0.0","keywords":["n8n-community-node-package","n8n","mem0","memory","ai","llm","long-term-memory","semantic-search","vector-database","ai-agent","agent-id","langchain"],"author":{"name":"kallbuloso"},"license":"MIT","_id":"@amaralkarl/n8n-nodes-mem0@2.0.0","maintainers":[{"name":"amaralkarl","email":"kallbuloso@gmail.com"}],"homepage":"https://github.com/kallbuloso/n8n-nodes-mem0#readme","bugs":{"url":"https://github.com/kallbuloso/n8n-nodes-mem0/issues"},"n8n":{"nodes":["dist/nodes/Mem0/Mem0.node.js","dist/nodes/Mem0/Mem0Memory.node.js","dist/nodes/Mem0/Mem0AiTools.node.js"],"credentials":["dist/credentials/Mem0Api.credentials.js","dist/credentials/Mem0SelfHostedApi.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"85bb9ea067f500e9bc15cb2967d73f88fc6065e5","tarball":"https://registry.npmjs.org/@amaralkarl/n8n-nodes-mem0/-/n8n-nodes-mem0-2.0.0.tgz","fileCount":52,"integrity":"sha512-3944g7nh11Q5YbHCIpkwLOOIBK3KlAySEHXuVu3qM0gmMEMW++EXst6PmOg5y8saD2NteQESyu1GnjdKirJ2XA==","signatures":[{"sig":"MEQCIC5YTVGVEXRUteqwPTl9LRVN9nGzkamClriCYH7KK9y6AiAxgHjnDx+C2jduFHW3pZPKnqC8B4lWVzsRcO1sASllEw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":221829},"main":"index.js","engines":{"node":">=18.0.0"},"gitHead":"3880f861e791f61088bcff9a2eb3f052d8a44f86","scripts":{"dev":"tsc --watch","lint":"eslint nodes credentials --ext .ts","build":"tsc && gulp build:icons","format":"prettier nodes credentials --write","lintfix":"eslint nodes credentials --ext .ts --fix","prepublishOnly":"npm run build"},"_npmUser":{"name":"amaralkarl","email":"kallbuloso@gmail.com"},"repository":{"url":"git+https://github.com/kallbuloso/n8n-nodes-mem0.git","type":"git"},"_npmVersion":"10.9.2","description":"n8n community node for Mem0 – intelligent memory layer for AI applications","directories":{},"_nodeVersion":"22.17.0","_hasShrinkwrap":false,"devDependencies":{"gulp":"^4.0.2","eslint":"^8.56.0","prettier":"^3.2.0","typescript":"^5.4.0","@types/node":"^20.14.0","n8n-workflow":"^1.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"peerDependencies":{"n8n-workflow":">=1.0.0"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-mem0_2.0.0_1775686643994_0.5391634306182345","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@amaralkarl/n8n-nodes-mem0","version":"2.0.1","description":"n8n community node for Mem0 – intelligent memory layer for AI applications","license":"MIT","author":{"name":"kallbuloso"},"repository":{"type":"git","url":"git+https://github.com/kallbuloso/n8n-nodes-mem0.git"},"homepage":"https://github.com/kallbuloso/n8n-nodes-mem0#readme","bugs":{"url":"https://github.com/kallbuloso/n8n-nodes-mem0/issues"},"engines":{"node":">=18.0.0"},"main":"index.js","scripts":{"build":"tsc && gulp build:icons","dev":"tsc --watch","lint":"eslint nodes credentials --ext .ts","lintfix":"eslint nodes credentials --ext .ts --fix","format":"prettier nodes credentials --write","prepublishOnly":"npm run build"},"n8n":{"n8nNodesApiVersion":1,"credentials":["dist/credentials/Mem0Api.credentials.js","dist/credentials/Mem0SelfHostedApi.credentials.js"],"nodes":["dist/nodes/Mem0/Mem0.node.js","dist/nodes/Mem0/Mem0Memory.node.js","dist/nodes/Mem0/Mem0AiTools.node.js"]},"keywords":["n8n-community-node-package","n8n","mem0","memory","ai","llm","long-term-memory","semantic-search","vector-database","ai-agent","agent-id","langchain"],"devDependencies":{"@types/node":"^20.14.0","@typescript-eslint/eslint-plugin":"^7.0.0","@typescript-eslint/parser":"^7.0.0","eslint":"^8.56.0","gulp":"^4.0.2","n8n-workflow":"^1.0.0","prettier":"^3.2.0","typescript":"^5.4.0"},"peerDependencies":{"n8n-workflow":">=1.0.0"},"_id":"@amaralkarl/n8n-nodes-mem0@2.0.1","gitHead":"3880f861e791f61088bcff9a2eb3f052d8a44f86","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-xECp249AA1HvMA3GVlCflE4UnrHoAa6KTzuo6iz53hwVOOVK+6iG5gA4SYiDp65Xz2zS+YBOgljxgrzD+AAQjg==","shasum":"212ea53db277a26c03c7a578c729b98a13b94827","tarball":"https://registry.npmjs.org/@amaralkarl/n8n-nodes-mem0/-/n8n-nodes-mem0-2.0.1.tgz","fileCount":52,"unpackedSize":222543,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDuVsTC0N9+IsaMCpeGVS9a+l6TyxDF1EeT5SQkxW40uAiAf/Hrt77oN7xNVFFyZx6ZoAzZi4gSq/x9pQzWb31PAIg=="}]},"_npmUser":{"name":"amaralkarl","email":"kallbuloso@gmail.com"},"directories":{},"maintainers":[{"name":"amaralkarl","email":"kallbuloso@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-mem0_2.0.1_1775700013019_0.9761584739042484"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-08T22:17:23.901Z","modified":"2026-04-09T02:00:13.265Z","2.0.0":"2026-04-08T22:17:24.160Z","2.0.1":"2026-04-09T02:00:13.166Z"},"bugs":{"url":"https://github.com/kallbuloso/n8n-nodes-mem0/issues"},"author":{"name":"kallbuloso"},"license":"MIT","homepage":"https://github.com/kallbuloso/n8n-nodes-mem0#readme","keywords":["n8n-community-node-package","n8n","mem0","memory","ai","llm","long-term-memory","semantic-search","vector-database","ai-agent","agent-id","langchain"],"repository":{"type":"git","url":"git+https://github.com/kallbuloso/n8n-nodes-mem0.git"},"description":"n8n community node for Mem0 – intelligent memory layer for AI applications","maintainers":[{"name":"amaralkarl","email":"kallbuloso@gmail.com"}],"readme":"# n8n-nodes-mem0\n\n[![npm version](https://img.shields.io/npm/v/@amaralkarl/n8n-nodes-mem0)](https://www.npmjs.com/package/@amaralkarl/n8n-nodes-mem0)\n[![npm downloads](https://img.shields.io/npm/dm/@amaralkarl/n8n-nodes-mem0)](https://www.npmjs.com/package/@amaralkarl/n8n-nodes-mem0)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nn8n community node package that integrates [Mem0](https://mem0.ai) — an intelligent memory layer for AI agents — into your n8n workflows.\n\nSupports both the **Mem0 cloud** (mem0.ai) and **self-hosted** Mem0 instances.\n\n---\n\n## Nodes Included\n\n| Node | Description |\n|---|---|\n| **Mem0** | Full CRUD node for managing memories, entities, organizations, projects, and config |\n| **Mem0 Chat Memory** | AI Agent memory source — supplies conversation history to an AI Agent node |\n| **Mem0 AI Tools** | AI Agent tools provider — exposes search, add, get, delete, and history as callable tools |\n\n---\n\n## Installation\n\n### Via Community Nodes UI (recommended)\n\n1. Open your n8n instance\n2. Go to **Settings → Community Nodes**\n3. Search for `@amaralkarl/n8n-nodes-mem0`\n4. Click **Install**\n\n### Manual\n\n```bash\nnpm install @amaralkarl/n8n-nodes-mem0\n```\n\nThen restart your n8n instance.\n\n---\n\n## Credential Setup\n\n### Cloud (mem0.ai)\n\n1. Sign up at [mem0.ai](https://mem0.ai) and obtain an API key\n2. In n8n, create a **Mem0 API** credential with:\n   - **API Key** (required)\n   - **Organization ID** (optional)\n   - **Project ID** (optional)\n\n### Self-Hosted\n\n1. Deploy a Mem0 OSS instance (see [mem0 docs](https://docs.mem0.ai/open-source/quickstart))\n2. In n8n, create a **Mem0 Self-Hosted API** credential with:\n   - **Base URL** (e.g., `http://localhost:8000`)\n   - **API Key** (optional, if your instance requires one)\n\n---\n\n## Node Reference\n\n### Mem0 (CRUD)\n\nGeneral-purpose node for managing all Mem0 resources.\n\n**Authentication:** Cloud or Self-Hosted\n\n#### Memory Operations (Cloud & Self-Hosted)\n\n| Operation | Description |\n|---|---|\n| Add | Store a message or conversation turn as a memory |\n| Get | Retrieve a single memory by ID |\n| Get All | List all memories for a user/agent/run |\n| Search | Semantic search using v1 endpoint |\n| Search V2 | Advanced semantic search with filter rules (cloud only) |\n| Update | Update a memory's text or metadata |\n| Delete | Delete a specific memory by ID |\n| Delete All | Delete all memories for a user/agent/run |\n| History | Get the change history of a memory |\n\n#### Entity Operations (Cloud)\n\nManage user, agent, app, and session entities.\nOperations: Create, Get, Get All, Update, Delete\n\n#### Organization Operations (Cloud)\n\nManage organizations with name, slug, description, and metadata.\nOperations: Create, Get, Get All, Update, Delete\n\n#### Project Operations (Cloud)\n\nManage projects within organizations.\nOperations: Create, Get, Get All, Update, Delete\n\n#### Config Operations (Self-Hosted)\n\n| Operation | Description |\n|---|---|\n| Health | Check instance health |\n| Get Config | Retrieve current configuration |\n| Switch | Switch between LLM providers (gemini, openrouter, nvidia, qwen) |\n| Configure | Full configuration update via JSON |\n| Reset | Reset configuration to defaults |\n\n---\n\n### Mem0 Chat Memory\n\nSupplies conversation history to an **AI Agent** node as a memory source.\n\nConnect the **Memory** output to the AI Agent's memory input.\n\n**Retrieval Modes:**\n\n| Mode | Description |\n|---|---|\n| Basic | Returns the last N raw memories, preserving role (user/assistant/system) |\n| Summary | Returns a single summarized text block of all memories |\n| Semantic (v1) | Semantic similarity search using the v1 `/memories/search/` endpoint |\n| Semantic (v2) | Advanced semantic search with metadata filters via the v2 endpoint |\n| Hybrid | Combines semantic v2 + recent memories, scored with time-decay and MMR diversity |\n\n**Hybrid mode parameters:**\n- **Alpha** — weight of semantic relevance vs. recency (0–1, default 0.65)\n- **Half-life (hours)** — decay rate for time-based scoring (default 48h)\n- **Max Return** — maximum memories returned to the agent (default 30)\n- **MMR Lambda** — balance between relevance and diversity (default 0.5)\n\n**Session ID:** Automatically reads `runId`, `sessionId`, or `chatId` from the incoming node data, or you can define a custom key (supports n8n expressions).\n\n---\n\n### Mem0 AI Tools\n\nExposes Mem0 operations as callable tools for an **AI Agent** node.\n\nConnect the **Tool** output to the AI Agent's tool input. The agent will decide when and how to call each tool.\n\n**Available Tools:**\n\n| Tool | Description |\n|---|---|\n| `mem0_search_memory` | Semantic search for relevant memories |\n| `mem0_add_memory` | Save new content as a memory |\n| `mem0_get_all_memories` | Retrieve all memories for a user/agent |\n| `mem0_delete_memory` | Delete a memory by ID |\n| `mem0_get_memory_history` | Get the change history of a memory |\n\nAll tools accept optional `user_id`, `agent_id`, and `run_id` overrides per call.\n\n---\n\n## Self-Hosted Notes\n\nThe self-hosted Mem0 instance does not use versioned API prefixes. This package automatically translates cloud endpoints:\n\n- `/v1/memories` → `/memories`\n- `/v2/memories/search/` → `/memories/search/`\n\nThe Config operations (health, getConfig, switch, configure, reset) are only available for self-hosted instances.\n\n---\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}