export

name	export
description	Exports all project memories to a portable Markdown file for backup or migration. Use when backing up memories, migrating to another project, sharing memory state with teammates, or archiving before cleanup.

Mem0 Export

Export all memories for the current project to a portable Markdown file.

Execution

Step 1: Resolve identity

Determine the active identity:

• user_id from MEM0_USER_ID env var, else $USER, else "default"
• project_id (used as app_id) from MEM0_PROJECT_ID env var, or via the project resolver

Step 2: Fetch all memories

Call get_memories with:

• filters={"AND": [{"user_id": "<active_user_id>"}, {"app_id": "<active_project_id>"}]}
• page_size=200

If the response is paginated (i.e. the result contains a next cursor or the count equals page_size), continue fetching pages until all memories are retrieved.

Step 3: Format each memory as a YAML-frontmatter block

For each memory record, produce a block in this exact format:

---
id: <memory.id>
created_at: <memory.created_at>
type: <memory.metadata.type or "">
confidence: <memory.metadata.confidence or "">
branch: <memory.metadata.branch or "">
files: <memory.metadata.files joined with ", " or "">
categories: <memory.categories joined with ", " or "">
---
<memory.memory or memory content string>

Notes:

• The --- delimiters must be on their own lines with no extra whitespace.
• files and categories are written as comma-separated values on a single line.
• Leave a blank line after the content before the next --- (for readability).
• If a field is missing or null, write an empty string (not "null").

Step 4: Write the export file

Determine the output filename:

mem0-export-<project_id>-<YYYY-MM-DD>.md

Where <YYYY-MM-DD> is today's date in UTC.

Write all formatted blocks to this file using the Write tool (or equivalent). The file is written to the current working directory.

Step 5: Print summary

Exported <N> memories to <filename>

Where <N> is the total number of memory blocks written.

Error Handling

• If get_memories returns an error or zero memories, print:

  No memories found for project <project_id>. Nothing exported.
  

• If the write fails, report the error to the user.