# Mem0 Memory MCP Server
[](https://smithery.ai/server/@big-omega/mem0-mcp)
A Model Context Protocol (MCP) server that provides memory storage and retrieval capabilities using [Mem0](https://github.com/mem0ai/mem0). This tool allows you to store and search through memories, making it useful for maintaining context and making informed decisions based on past interactions.
## Features
- Store memories with user-specific context
- Search through stored memories with relevance scoring
- Simple and intuitive API
- Built on the Model Context Protocol
- Automatic error handling
- Support for multiple user contexts
## Installation
### Installing via Smithery
To install Mem0 Memory Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@big-omega/mem0-mcp):
```bash
npx -y @smithery/cli install @big-omega/mem0-mcp --client claude
```
### Running with npx
```bash
env MEM0_API_KEY=your-api-key-here npx -y @mem0/mcp
```
### Manual Installation
```bash
npm install -g @mem0/mcp
```
## Configuration for AI Tools
### Running on Cursor
#### Configuring Cursor 🖥️
To configure Mem0 MCP in Cursor:
1. Open Cursor Settings
2. Go to Features > MCP Servers
3. Click "+ Add New MCP Server"
4. Enter the following:
- Name: "mem0-mcp" (or your preferred name)
- Type: "command"
- Command: `env MEM0_API_KEY=your-api-key-here npx -y @mem0/mcp`
To configure Mem0 MCP using JSON configuration:
```json
{
"mcpServers": {
"mem0-mcp": {
"command": "npx",
"args": ["-y", "@mem0/mcp"],
"env": {
"MEM0_API_KEY": "YOUR-API-KEY-HERE"
}
}
}
}
```
### Running on VS Code
Add the following JSON block to your User Settings (JSON) file in VS Code:
```json
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "Mem0 API Key",
"password": true
}
],
"servers": {
"mem0-memory": {
"command": "npx",
"args": ["-y", "@mem0/mcp"],
"env": {
"MEM0_API_KEY": "${input:apiKey}"
}
}
}
}
}
```
## Available Tools
### 1. Add Memory Tool (add-memory)
Store new memories with user-specific context.
```json
{
"name": "add-memory",
"arguments": {
"content": "User prefers dark mode interface",
"userId": "user123"
}
}
```
### 2. Search Memories Tool (search-memories)
Search through stored memories to retrieve relevant information.
```json
{
"name": "search-memories",
"arguments": {
"query": "What are the user's interface preferences?",
"userId": "user123"
}
}
```
## Response Format
### Add Memory Response
```json
{
"content": [
{
"type": "text",
"text": "Memory added successfully"
}
],
"isError": false
}
```
### Search Memory Response
```json
{
"content": [
{
"type": "text",
"text": "Memory: User prefers dark mode interface\nRelevance: 0.95\n---\nMemory: User mentioned liking minimal UI\nRelevance: 0.82\n---"
}
],
"isError": false
}
```
## Configuration
### Environment Variables
- `MEM0_API_KEY`: Your Mem0 API key (required)
- Required for operation
- Can be obtained from [Mem0 Dashboard](https://app.mem0.ai/dashboard/api-keys)
## Development
### Prerequisites
- Node.js (v14 or higher)
- A Mem0 API key
### Setup
1. Clone the repository
2. Install dependencies:
```bash
npm install
```
3. Create a `.env` file in the root directory and add your Mem0 API key:
```bash
MEM0_API_KEY=your-api-key-here
```
### Running Development Server
To run the server in development mode:
```bash
npm run dev
```
### Building
To build the project:
```bash
npm run build
```
### Starting the Server
To start the server after building:
```bash
npm start
```
## Error Handling
The server includes error handling for:
- API connection issues
- Invalid memory operations
- Search errors
- Authentication failures
Example error response:
```json
{
"content": [
{
"type": "text",
"text": "Error: Failed to search memories: Invalid API key"
}
],
"isError": true
}
```
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
MIT
