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"
}
}