Back to Mem0

Quickstart

docs/platform/quickstart.mdx

2.0.14.0 KB
Original Source

Get started with Mem0 Platform's hosted API in under 5 minutes. This guide shows you how to authenticate and store your first memory.

Prerequisites

  • Mem0 Platform account (<a href="https://app.mem0.ai?utm_source=oss&utm_medium=platform-quickstart" rel="nofollow">Sign up here</a>)
  • API key (<a href="https://app.mem0.ai/dashboard/settings?tab=api-keys&subtab=configuration" rel="nofollow">Get one from dashboard</a>)
  • Python 3.10+, Node.js 14+, or cURL

Installation

<Steps> <Step title="Install SDK"> <CodeGroup> ```bash pip pip install mem0ai ```
bash
npm install mem0ai
</CodeGroup> </Step> <Step title="Set your API key"> <CodeGroup> ```python Python from mem0 import MemoryClient

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


```javascript JavaScript
import MemoryClient from 'mem0ai';
const client = new MemoryClient({ apiKey: 'your-api-key' });
bash
export MEM0_API_KEY="your-api-key"
bash
mem0 init --api-key "your-api-key"
</CodeGroup> </Step> <Step title="Add a memory"> <CodeGroup> ```python Python 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") ````
javascript
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" });
bash
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"
  }'
bash
mem0 add "I'm a vegetarian and allergic to nuts." --user-id user123
</CodeGroup> </Step> <Step title="Search memories"> <CodeGroup> ```python Python results = client.search("What are my dietary restrictions?", filters={"user_id": "user123"}) print(results) ````
javascript
const results = await client.search("What are my dietary restrictions?", { filters: { user_id: "user123" } });
console.log(results);
bash
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"}
  }'
bash
mem0 search "What are my dietary restrictions?" --user-id user123
</CodeGroup>

Output:

json
{
  "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
    }
  ]
}
</Step> </Steps> <Callout type="tip" icon="plug"> **Pro Tip**: Want AI agents to manage their own memory automatically? Use <Link href="/platform/mem0-mcp">Mem0 MCP</Link> to let LLMs decide when to save, search, and update memories. </Callout>

What's Next?

<CardGroup cols={3}> <Card title="Memory Operations" icon="database" href="/core-concepts/memory-operations/add"> Learn how to search, update, and delete memories with complete CRUD operations </Card> <Card title="Platform Features" icon="star" href="/platform/features/platform-overview"> Explore advanced features like metadata filtering, graph memory, and webhooks </Card> <Card title="API Reference" icon="code" href="/api-reference/memory/add-memories"> See complete API documentation and integration examples </Card> </CardGroup>

Additional Resources