Skip to main content
Get started with Mem0 Platform’s hosted API in under 5 minutes. This guide shows you how to authenticate and store your first memory.
Are you an AI agent? See Sign up as an agent: mint a working API key in four commands, no email or dashboard required.

​
Prerequisites

​
Installation

1

Install SDK

pip install mem0ai

npm install mem0ai
2

Set your API key

from mem0 import MemoryClient

client = MemoryClient(api_key="your-api-key")

import MemoryClient from 'mem0ai';
const client = new MemoryClient({ apiKey: 'your-api-key' });

export MEM0_API_KEY="your-api-key"

mem0 init --api-key "your-api-key"
3

Add a memory

messages = [
    {"role": "user", "content": "I'm a vegetarian and allergic to nuts."},
    {"role": "assistant", "content": "Got it! I'll remember your dietary preferences."}
]
client.add(messages, user_id="user123")

const messages = [
    {"role": "user", "content": "I'm a vegetarian and allergic to nuts."},
    {"role": "assistant", "content": "Got it! I'll remember your dietary preferences."}
];
await client.add(messages, { userId: "user123" });

curl -X POST https://api.mem0.ai/v3/memories/add/ \
  -H "Authorization: Token $MEM0_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Im a vegetarian and allergic to nuts."},
      {"role": "assistant", "content": "Got it! Ill remember your dietary preferences."}
    ],
    "user_id": "user123"
  }'

mem0 add "I'm a vegetarian and allergic to nuts." --user-id user123
4

Search memories

results = client.search("What are my dietary restrictions?", filters={"user_id": "user123"})
print(results)

const results = await client.search("What are my dietary restrictions?", { filters: { user_id: "user123" } });
console.log(results);

curl -X POST https://api.mem0.ai/v3/memories/search/ \
  -H "Authorization: Token $MEM0_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What are my dietary restrictions?",
    "filters": {"user_id": "user123"}
  }'

mem0 search "What are my dietary restrictions?" --user-id user123
Output:
{
  "results": [
    {
      "id": "14e1b28a-2014-40ad-ac42-69c9ef42193d",
      "memory": "Allergic to nuts",
      "user_id": "user123",
      "categories": ["health"],
      "created_at": "2025-10-22T04:40:22.864647-07:00",
      "score": 0.30
    }
  ]
}
Pro Tip: Want AI agents to manage their own memory automatically? Use Mem0 MCP to let LLMs decide when to save, search, and update memories.

​
What’s next?

You stored and searched your first memory. Keep going:

How it works

See how Mem0 extracts, stores, and retrieves memories under the hood.

Memory operations

Go beyond add and search: update, delete, and the full memory lifecycle.

Build an AI companion

Put it to work in a real app, end to end, in about 10 minutes.
Stuck on setup? See the FAQs and troubleshooting.