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.
Add, search, and retrieve memories.
Add memories to Mem0 for persistent storage and retrieval
Parameter Type Required Description userIdstring Yes User ID associated with the memory (e.g., "user_123", "alice@example.com ") messagesjson Yes Array of message objects with role and content (e.g., [{"role": "user", "content": "Hello"}]) apiKeystring Yes Your Mem0 API key
Parameter Type Description messagestring Status message for the queued memory processing job statusstring Processing status returned by Mem0 event_idstring Event ID for polling memory processing status
Search for memories in Mem0 using semantic search
Parameter Type Required Description userIdstring Yes User ID to search memories for (e.g., "user_123", "alice@example.com ") querystring Yes Search query to find relevant memories (e.g., "What are my favorite foods?") limitnumber No Maximum number of results to return (e.g., 10, 50, 100) apiKeystring Yes Your Mem0 API key
Parameter Type Description searchResultsarray 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 idsarray Array of memory IDs found in the search results
Retrieve memories from Mem0 by ID or filter criteria
Parameter Type Required Description userIdstring Yes User ID to retrieve memories for (e.g., "user_123", "alice@example.com ") memoryIdstring No Specific memory ID to retrieve (e.g., "mem_abc123") startDatestring No Start date for filtering by created_at (e.g., "2024-01-15") endDatestring No End date for filtering by created_at (e.g., "2024-12-31") limitnumber No Maximum number of results to return (e.g., 10, 50, 100) pagenumber No Page number to retrieve for paginated list results apiKeystring Yes Your Mem0 API key
Parameter Type Description memoriesarray 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 idsarray Array of memory IDs that were retrieved countnumber Total number of memories matching the filters nextstring URL for the next page of results previousstring URL for the previous page of results