Skip to content
Docs menu

Tool reference · Edit, history & reports

memory_export

Exports active knowledge, sessions and relations as JSON, either to a backup file or directly in the response.

local stdio server read-only

When to use

  • Before running memory_forget or a large cleanup.
  • You are moving memory to another machine or want a snapshot for one project.

Parameters

NameTypeDefaultDescription
project string — Export only this project (optional)
save_to_file boolean true Save to <memory-dir>/backups/ (default true)

Example

Arguments

{
  "project": "my-api",
  "save_to_file": true
}

Result shape

{
  "exported": true,
  "file": "~/.tam/backups/export_my-api_20260925_101500.json",
  "knowledge_count": 103,
  "sessions_count": 57
}

With save_to_file: false the full export (version, exported_at, knowledge, sessions, relations) is returned inline, which can be very large.

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:

Export all knowledge as JSON for backup or migration. Includes knowledge, sessions, and relations.

Found a mistake? Open an issue on GitHub.

Search