Skip to main content
Temporal Reasoning gives a ranking boost to memories whose event dates match the time in a search. Event dates are when something described in a memory happened or will happen. It runs automatically on Mem0 Platform v3. It is not available in the OSS SDK. Dates from new memories usually affect search within a few seconds.

Time-aware searches

Queries can include expressions such as yesterday, last week, tomorrow, currently, and as of March 2025. Mem0 compares them with dates and date ranges found in stored memories.

Example

Suppose a user has these memories:
  • “Yesterday I met Maya at the Orion conference in Paris.”
  • “Last week I met Maya at the Orion conference in Tokyo.”
  • “Last year I met Maya at the Orion conference in Lisbon.”
Searching for Which city did I meet Maya in at the Orion conference last week? gives the Tokyo memory a temporal boost and ranks it first.
Search returns the usual memory results, reordered using the temporal boost.

Search from a specific time

Use reference_date to simulate searching at a specific date and time. Mem0 treats it as the current time for that search.

Parameters

For all search inputs and returned fields, see the Search Memories API reference.

Memory Timestamps

Preserve the original time of imported memories.

Discord

Join our community

GitHub

Ask questions on GitHub

Support

Talk to founders