Skip to content

import_agent_memory

Import agent memory files (Claude/Copilot/Cursor/Codex/Gemini/markdown) from a server-side path into long-term memory, preserving inter-memory links. Admin-gated; idempotent; supports dryRun and a secrets policy. Never overwrites a memory edited inside ENGRAM since its last import: such facts are skipped and counted as skippedConcurrentEdit in the summary (CAS-skip).

Auth mode: admin
Admin tool: requires MCP_ADMIN_TOKEN.

Parameter Type Required Default Description
adminToken string yes
source claude-code | copilot | cursor | codex | gemini | markdown yes
path string yes
userId string yes
scope string no
dryRun boolean no
secretsPolicy redact | flag | skip | fail no
embed boolean no
splitHeadings boolean no
includeGlobal boolean no
{
"name": "import_agent_memory",
"arguments": {
"adminToken": "<adminToken>",
"source": "claude-code",
"path": "<path>",
"userId": "qp"
}
}