MemoryLake
Back to all articles
TutorialMay 25, 20266 min read

Cursor → Claude Code: Migrate Your AI Memory (2026 Method)

Cursor lives inside an IDE; Claude Code lives in your terminal. The rules transfer one-to-one, but Notepads, MCP wiring, and slash-command habits need a rebuild. Here's the real plan.

The short answer

Cursor's .cursorrules, .cursor/rules/*.mdc, and Notepads don't auto-import into Claude Code. You'll consolidate your rules into a CLAUDE.md at the repo root (and ~/.claude/CLAUDE.md for global), translate Notepads into custom slash commands, and rewire MCP servers in Claude Code's settings. Plan 15–30 minutes per repo. A shared MCP-based memory layer like MemoryLake lets both tools read the same source.

Why people switch from Cursor to Claude Code

Three drivers in 2026:

  • Terminal-native workflow. Engineers shipping multi-repo refactors often prefer Claude Code's CLI flow over an IDE.
  • Long-running agent tasks. Claude Code handles longer multi-step tasks with deeper context per session.
  • MCP-first defaults. Claude Code's first-class MCP support fits teams already standardizing on MCP servers for tools and memory.

What "memory" means in Cursor vs Claude Code

Different surface, similar intent.

Cursor memory spans `.cursorrules` (legacy single-file project rules), *`.cursor/rules/.mdc` (structured per-rule format with metadata), Notepads (saved reusable prompts), and user-level Rules for AI** in Settings.

Claude Code memory centers on `CLAUDE.md` at the repo root (project-level guidance), `~/.claude/CLAUDE.md` (user-global guidance), custom slash commands (reusable prompts saved as .md files), and MCP servers configured in Claude Code settings.

A .cursorrules file usually becomes a CLAUDE.md. .mdc rules collapse into sections of CLAUDE.md. Notepads become custom slash commands.

Step 1: Export your Cursor rules

There's no Cursor export command; rules are files you copy.

  1. Locate your repo's rules. Check .cursorrules and .cursor/rules/.
  2. Read each `.mdc` rule's frontmatter and body. Note which apply always and which apply on certain globs.
  3. Export your Notepads. Copy each Notepad's name and content into a notepads.md.
  4. Capture user-level Rules for AI. Settings → Rules for AI. Paste into cursor-user-rules.txt.

End state: a cursor-export/ folder per repo containing the rules files (or contents), notepads.md, and cursor-user-rules.txt.

Step 2: Import into Claude Code

Claude Code expects a CLAUDE.md and a .claude/commands/ directory.

  1. Create `CLAUDE.md` at the repo root. Start with your .cursorrules content. Add a clear section heading for each .mdc rule cluster.
  2. Add glob notes inline. Where a .mdc had a globs pattern, mention it in prose ("for files under src/api/...") so the model applies the guidance contextually.
  3. Add user-global guidance to `~/.claude/CLAUDE.md`. Paste your Cursor user-level Rules for AI.
  4. Translate Notepads into slash commands. For each Notepad, create .claude/commands/<name>.md containing the prompt body. Claude Code exposes it as /<name>.
  5. Configure MCP servers. Edit Claude Code settings to add any MCP servers you previously used in Cursor. Reuse endpoint URLs and Bearer tokens.
  6. Probe. Run a small task in Claude Code that depends on a moved rule.

What you'll still lose after migrating

  • `.mdc` frontmatter semantics. Claude Code reads CLAUDE.md as prose; glob-based selective application doesn't transfer automatically.
  • IDE-specific affordances. Inline Tab completion and Cursor-style chat are IDE features, not CLI ones.
  • Per-IDE chat history. Cursor's chats stay in the IDE.
  • Ongoing sync. New .cursorrules edits next week won't appear in CLAUDE.md unless you redo the copy.

The better way: one memory layer, every tool

If you work across IDEs and the terminal, per-tool rules files drift fast. Worse, anything broader than a single repo (cross-repo conventions, team standards) lives in two places.

MemoryLake holds those rules and standards once and exposes them through MCP. Both Cursor and Claude Code support MCP, so the same project context flows into both from a single endpoint.

  • One source of truth. Update a rule once; both tools see the change.
  • Cross-repo standards. Team conventions live above any single repo.
  • Drop-in for the next tool. Add Windsurf or a future agent with a config change.

Connect MemoryLake in 3 steps

Step 1: Create a project and load your context

Sign in to MemoryLake, open Project Management, and click Create Project. Name it "Cursor ↔ Claude Code shared rules." Drag reference docs (style guides, ADRs as PDF, Word, Markdown, or images) into the Document Drive under My Space, then open the Documents Tab and click Add Documents. Paste your .cursorrules, .mdc bodies, Notepads, and user-level rules into the Memories Tab via Add Memory.

Step 1: Create a project and load your context
Step 1: Create a project and load your context

Step 2: Generate an MCP Server endpoint

Open the MCP Servers Tab inside the project, click Add MCP Server, describe it (e.g., "Shared dev rules"), and click Generate. MemoryLake returns a Key ID, a Secret, and an Endpoint URL. Copy the Secret immediately — it is shown only once.

Step 2: Generate an MCP Server endpoint
Step 2: Generate an MCP Server endpoint

Step 3: Point both tools at the endpoint

In Cursor's MCP configuration (e.g., .cursor/mcp.json), add a MemoryLake server entry with the endpoint URL and the Secret as a Bearer token. In Claude Code's settings, add the same MCP server. Restart Cursor and re-open Claude Code.

Step 3: Point both tools at the endpoint
Step 3: Point both tools at the endpoint

Native migration vs MemoryLake

DimensionNative Cursor → Claude CodeMemoryLake bridge
Steps required7–10 manual3 one-time
Estimated time15–30 min per repo~5 min setup
Preserves .mdc glob semanticsNo (prose only)Memories survive verbatim
Cross-repo standardsPer-repo onlyShared once
Syncs ongoing changesNoYes
Works with a third tool laterNo (rebuild)Yes (add MCP)

Frequently asked questions

Can I just rename `.cursorrules` to `CLAUDE.md`?

For simple cases, the rename plus a few section headers works. .mdc glob behavior won't carry over — you mention the applicable paths in prose.

Do Notepads become slash commands automatically?

No. You create .claude/commands/<name>.md files manually.

Will Claude Code read my MCP servers from Cursor's config?

No. They share the MCP protocol but have separate configuration files. You'd add each MCP server to Claude Code's settings.

How long does the migration usually take?

Plan 15–30 minutes per repo, longer with many Notepads or MCP servers.

Can I keep Cursor and Claude Code in sync going forward?

Yes — connect both to a shared MemoryLake Project via the MCP Server endpoint so rule updates propagate to both.