Use cases and templates: Mem0 integration for AI agents
Use Mem0 to store persistent memories, search them by meaning, and retrieve memory records across workflow runs. Store conversation context or user preferences, then retrieve relevant memories for a later agent step.
Use the block
Add, search, and retrieve memories.
Actions
Add Memories
Add memories to Mem0 for persistent storage and retrieval
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | User ID associated with the memory (e.g., "user_123", "alice@example.com") |
messages | json | Yes | Array of message objects with role and content (e.g., [{"role": "user", "content": "Hello"}]) |
apiKey | string | Yes | Your Mem0 API key |
Output
| Parameter | Type | Description |
|---|---|---|
message | string | Status message for the queued memory processing job |
status | string | Processing status returned by Mem0 |
event_id | string | Event ID for polling memory processing status |
Search Memories
Search for memories in Mem0 using semantic search
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | User ID to search memories for (e.g., "user_123", "alice@example.com") |
query | string | Yes | Search query to find relevant memories (e.g., "What are my favorite foods?") |
limit | number | No | Maximum number of results to return (e.g., 10, 50, 100) |
apiKey | string | Yes | Your Mem0 API key |
Output
| Parameter | Type | Description |
|---|---|---|
searchResults | array | Array of search results with memory data and similarity scores |
↳ id | string | Unique identifier for the memory |
↳ memory | string | The content of the memory |
↳ user_id | string | User ID associated with this memory |
↳ agent_id | string | Agent ID associated with this memory |
↳ app_id | string | App ID associated with this memory |
↳ run_id | string | Run/session ID associated with this memory |
↳ hash | string | Hash of the memory content |
↳ metadata | json | Custom metadata associated with the memory |
↳ categories | json | Auto-assigned categories for the memory |
↳ created_at | string | ISO 8601 timestamp when the memory was created |
↳ updated_at | string | ISO 8601 timestamp when the memory was last updated |
↳ score | number | Similarity score from vector search |
ids | array | Array of memory IDs found in the search results |
Get Memories
Retrieve memories from Mem0 by ID or filter criteria
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | User ID to retrieve memories for (e.g., "user_123", "alice@example.com") |
memoryId | string | No | Specific memory ID to retrieve (e.g., "mem_abc123") |
startDate | string | No | Start date for filtering by created_at (e.g., "2024-01-15") |
endDate | string | No | End date for filtering by created_at (e.g., "2024-12-31") |
limit | number | No | Maximum number of results to return (e.g., 10, 50, 100) |
page | number | No | Page number to retrieve for paginated list results |
apiKey | string | Yes | Your Mem0 API key |
Output
| Parameter | Type | Description |
|---|---|---|
memories | array | Array of retrieved memory objects |
↳ id | string | Unique identifier for the memory |
↳ memory | string | The content of the memory |
↳ user_id | string | User ID associated with this memory |
↳ agent_id | string | Agent ID associated with this memory |
↳ app_id | string | App ID associated with this memory |
↳ run_id | string | Run/session ID associated with this memory |
↳ hash | string | Hash of the memory content |
↳ metadata | json | Custom metadata associated with the memory |
↳ categories | json | Auto-assigned categories for the memory |
↳ created_at | string | ISO 8601 timestamp when the memory was created |
↳ updated_at | string | ISO 8601 timestamp when the memory was last updated |
ids | array | Array of memory IDs that were retrieved |
count | number | Total number of memories matching the filters |
next | string | URL for the next page of results |
previous | string | URL for the previous page of results |