list_sessions
List recent Claude Code sessions by newest first. Use this to discover session IDs for browsing or reading specific sessions.
Instructions
List the most-recent Claude Code sessions (conversations) in the index, newest first. This is the browse/discovery entry point: use it to find out what sessions exist and get their session_id values before calling 'session' (read one in full) or 'recent' (latest messages). Prefer 'search' when you are looking for specific content rather than browsing. Returns one row per session — session_id, project, message count, and last-activity time. Read-only; never modifies the index.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_sessions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project | No | only list sessions in this project slug | |
| limit | No | max sessions to return, newest first (default 50) |