# recordings

> Reference for the recordings tool of Recaloo: kept recordings, chapters and usage, with every action.

Source: https://recaloo.tech/docs/reference/recordings/

The recordings a person has kept. Recording itself happens in the person's browser, so an agent can read recordings but never make one.

Call it as the `recordings` tool of the Recaloo MCP server with `action` and `args`.

## Actions

| Action | What it does |
|---|---|
| `list` | Kept recordings, newest first, with each file's URL, length, starting layout, every layout used, framing and the script read. |
| `read` | One recording, also its marks (layout and source switches, screenshots, with their time atMs) and its screenshots. |
| `chapters` | A recording's chapters [{atMs, title}] from the layout and source switches, and the same as text for a video description ("00:00 Intro" lines). |
| `review_material` | Everything to review one take with, for the person's own AI. |
| `save_review` | Saves your review of a take so the person reads it in Recaloo (Recordings) and can use it for the next take. |
| `reviews` | The saved reviews of a take, newest first: id, by, model, summary, scores, missed, improvedBullets, forgottenPoints, nextTake, applied. |
| `captions` | Captions for a take as a text file (WebVTT, or SRT with format:"srt"): the words of the script that was read, paced evenly over the take or its trim window. |
| `trim` | Sets the trim window of a take: start_ms and end_ms are milliseconds from the file's start (at least 1 second kept, inside the take). |
| `rename` | Gives a recording a new title (up to 140 characters). |
| `star` | Stars a recording (the takes to keep; starred:true) or clears the star (starred:false). |
| `usage` | How many recordings are kept against the plan. |

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "list"`. The server answers from its own definitions, so that answer is always current.