Get memory statistics
memory_statsShow aggregate statistics about stored memories: the total count, a breakdown by memory_type and by collection, and storage bytes used versus the plan limit. Use to understand what is stored before browsing with list_memories, or to check remaining storage capacity. To show stats for a team workspace instead of personal memory, pass workspace: .
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspace | No | To operate on a team workspace, pass its exact name, slug, or ID (e.g. "Acme"). Omit — or pass "personal" — for your personal memory (default). Every response echoes resolved_workspace so you can confirm where the operation actually happened. Call list_collections when unsure of the exact workspace name. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Total number of memories. | |
| by_type | Yes | Count per memory_type. | |
| message | Yes | Human-readable statistics (same as content text). | |
| by_collection | Yes | Count per collection slug. | |
| resolved_workspace | No | The workspace this call actually operated on (defense against writing to the wrong team by typo or name collision). id=null means Personal. | |
| storage_bytes_used | No | Total storage bytes used (content + metadata + embedding). | |
| storage_bytes_limit | No | Plan storage limit in bytes (-1 = unlimited). |