Tool reference · Edit, history & reports
memory_timeline
Browses past sessions with the events and knowledge recorded in each, by position, by date range, or by a text query.
local stdio server read-only
When to use
- You want to know what happened "two sessions ago" or in your very first session.
- You need everything recorded between two dates.
- You remember a topic but not when you worked on it.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
query | string | — | — |
session_number | integer | — | — |
sessions_ago | integer | — | — |
date_from | string | — | YYYY-MM-DD |
date_to | string | — | YYYY-MM-DD |
project | string | — | — |
limit | integer | 5 | — |
Example
Arguments
{
"date_from": "2026-09-20",
"date_to": "2026-09-24",
"project": "my-api",
"limit": 2
}Result shape
{
"total_sessions": 57,
"returned": 1,
"sessions": [
{
"id": "a1b2c3",
"started_at": "2026-09-20T09:58:12Z",
"ended_at": "2026-09-20T11:40:03Z",
"project": "my-api",
"status": "closed",
"summary": "Moved billing job locking to PostgreSQL.",
"log_count": 12,
"session_number": 55,
"events": [],
"knowledge": []
}
]
}Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.
Server description
The description the server sends to your agent in tools/list, captured from the v14.7.0 source:
Browse session history. sessions_ago=N for 'N sessions ago', session_number=1 for first session, date_from/date_to for date ranges.