Migrate

Move your Supermemory documents and memories into Markdown notes.

Export with the Supermemory API, import with one command, verify the result, and connect your agent. The full guide has the export scripts, every option, and what to do about connectors.

Import from Supermemory and the local MCP server are available from source until the next release. Supermemory’s features were checked on September 26, 2026.

How Supermemory concepts map to a vault

A vault is a folder of Markdown notes in Git. Most Supermemory concepts become notes, fields, or relations.

Read the full migration guide

Supermemory	Wordcell
Container tag	A vault per project or person. Imported documents keep their tags in `container_tag` and `container_tags`.
Document	A note under `articles/` or `notes/imported/`.
Memory entry and its versions	One note per version under `notes/imported/memories/`, each linked to the one before it by a `supersedes` relation.
User profile	A `type: profile` note that your agent maintains.
Automatic extraction	Notes that you or your agent write. `wordcell percolate` suggests connections for you to review.
Hosted MCP server	`wordcell mcp`, a local server whose tools include `search`, `list_notes`, `get_note`, `create_note`, and `update_note_body`.

See the full concept map

Install, export, import, and verify

Work in a directory outside the Wordcell checkout and outside any vault, so that the export files are never committed.

1Install Wordcell from source

You need Bun 1.3.14 or newer and Git.

git clone https://github.com/hraness/wordcell.git
cd wordcell
bun install --frozen-lockfile
bun link

Details

2Export your data

Leave the Wordcell checkout, for example with cd ... Save the guide’s export script in your working directory and set SUPERMEMORY_API_KEY. The script uses curl and jq.

sh export-supermemory.sh <tag>...

The script saves your documents, and the memory entries for each container tag, as JSON pages. A Python version saves one supermemory-export.json file. Details

3Import into a vault

Run wordcell init kb only if you do not have a vault yet. With the Python script, name supermemory-export.json in place of the two patterns.

wordcell init kb
wordcell import supermemory documents-*.json memories-*.json --root kb --dry-run
wordcell import supermemory documents-*.json memories-*.json --root kb
wordcell refresh --root kb
wordcell check --root kb

The dry run counts what the import would create, update, skip, report as a conflict, or reject, and writes nothing. Import again at any time: notes you edited since the last import are reported as conflicts and left unchanged. Details

4Verify and commit

Search for a phrase you remember saving. Skip git init when the vault is inside a project repository.

wordcell list --root kb --where imported_from=supermemory
wordcell search "dark mode" --root kb --mode exact
cd kb
git init -b main
git add -A
git commit -m "Import Supermemory export"

Details

Connect your agent

Wordcell’s local MCP server serves the vault to a local agent over standard input and output. It needs no account.

Set up Wordcell as local memory for my coding agent. Wordcell keeps notes as Markdown files in a vault on my computer. If you can run commands, ask me before each one. Otherwise, give me each command to run.

1. Install Wordcell from source, because `wordcell mcp` is available from source until the next release. This needs Git and Bun 1.3.14 or later:
   git clone https://github.com/hraness/wordcell.git
   cd wordcell
   bun install --frozen-lockfile
   bun link
2. Unless I already have a vault, create one: wordcell init ~/kb
3. Register the MCP server with the vault's absolute path. Claude Code: claude mcp add --transport stdio --scope user wordcell -- wordcell mcp --root /absolute/path/to/kb
   Codex: codex mcp add wordcell -- wordcell mcp --root /absolute/path/to/kb
   Cursor: add a "wordcell" server to ~/.cursor/mcp.json. Other clients: https://wordcell.io/docs/reference#connect-a-client
4. Install the Wordcell skill: bunx skills add hraness/wordcell --skill wordcell
5. When I ask you to remember a conversation, follow the skill's session-memory reference.

Open in ChatGPTStarts a chat with the prompt right away.
Open in GrokOpens with the prompt filled in.
Open in CursorOpens Cursor with the prompt filled in. Cursor does not run it until you send it.

ChatGPT and Grok cannot run commands on your computer. They give you each command to run, and the vault then serves a local agent such as Claude Code, Codex, or Cursor.

In Claude Code or Codex, paste the prompt. With Wordcell installed from source, you can register the server yourself. Replace /absolute/path/to/kb with your vault’s absolute path.

Claude Code

claude mcp add --transport stdio --scope user wordcell -- wordcell mcp --root /absolute/path/to/kb

Codex

codex mcp add wordcell -- wordcell mcp --root /absolute/path/to/kb

To keep a profile like Supermemory’s, ask your agent to follow the Wordcell skill’s session-memory reference. Connect your agent in the guide has each client’s setup.

What does not transfer

These hosted Supermemory features have no Wordcell equivalent.

The facts and relations Supermemory infers from patterns across memories, and its time-based forgetting of temporary facts.
Managed connectors. The guide shows how to replace them with exports.
The hosted MCP server’s spaces and OAuth sign-in.

Read what does not transfer in the guide

Compare Wordcell and Supermemory