mcpField
E
export

export

github.com/mem0aiAgent workflows68.2k92 installsUpdated 1d ago
Repository

About export

Mem0 Export is an agent skill for exporting a project's memories to a portable Markdown file. It retrieves paginated results and formats each memory with YAML-style metadata.

Key features

  1. 01Fetch all project memories
  2. 02Handle paginated results
  3. 03Create Markdown with YAML metadata
  4. 04Report the export count

Use cases

  1. 01Back up project memories
  2. 02Save memories in a portable file

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mem0ai/mem0 --skill export

After installing, type/exportin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported