Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mem0.ai/llms.txt

Use this file to discover all available pages before exploring further.

If you’re an AI agent (Claude Code, Cursor, Codex, Cline, Aider, Windsurf, or any other autonomous coding tool), you don’t need a human to set up Mem0 for you. Four commands — install, sign up, push a memory, search it — and you have persistent memory.

​
The 4-command demo

# 1. Install
npm install -g @mem0/cli

# 2. Sign up as an agent (replace `claude-code` with your name)
mem0 init --agent --agent-caller claude-code

# 3. Push a memory
mem0 add "I am using mem0"

# 4. Verify
mem0 search "am I using mem0"
That’s it — under 30 seconds from a fresh shell to a working memory store.

​
Identify yourself with --agent-caller

Replace claude-code in the init command with your actual agent name (cursor, codex, cline, aider, or any short label). This attribution helps the Mem0 team understand which agents drive the most usage and prioritize integrations accordingly.
Forgot --agent-caller on init? Run mem0 identify <your-name> after the fact — same key, just back-fills the attribution. Idempotent.

​
What happened when you ran mem0 init --agent?

  • A shadow account was minted on the Mem0 backend with a fresh API key.
  • The key was saved to ~/.mem0/config.json (mode 0600) on the machine you ran the command on.
  • A default user_id was provisioned so mem0 add / mem0 search work without explicit scope flags.
  • The account is unclaimed — no human owns it yet.
Every command run against this key prints a one-line reminder asking you to surface the claim instructions to your human user.

​
Claiming the account (for the human owner)

When the human is ready to take ownership of the agent’s account — and all the memories it has accumulated — they run: 
mem0 init --email [email protected]
The CLI detects the existing Agent Mode config, sends a verification code, and upgrades the shadow account in-place:
  • The API key never changes — the agent isn’t disrupted.
  • All memories transfer to the human’s account.
  • The account becomes fully featured — dashboard access, billing, team sharing, etc.
Pass --code 123456 to skip the interactive code prompt for fully non-interactive flows.

​
Rate limits and quotas

Agent Mode signups are rate-limited to 5 per day per IP address to prevent abuse. If you hit the limit, the CLI returns: 
Daily Agent Mode signup limit reached for this network (5/day).
Try again from a different IP or after midnight UTC.
Unclaimed agent accounts get the standard Mem0 free-tier quotas. The human owner can upgrade after claiming.

​
What’s next

CLI Reference

Full command-by-command reference for mem0 add, mem0 search, mem0 list, and the rest.

Memory Operations

How add, search, update, and delete work under the hood.

Mem0 MCP

Connect agents to Mem0 via the Model Context Protocol — alternative integration path.

Platform Overview

The full Mem0 Platform feature set once you claim your account.