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 info
npm install openmemoryA Model Context Protocol (MCP) server that provides memory storage and retrieval capabilities using 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.
- 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
``bash`
env MEM0_API_KEY=your-api-key-here npx -y @mem0/mcp
`bash`
npm install -g @mem0/mcp
#### 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"
}
}
}
}
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}"
}
}
}
}
}
Store new memories with user-specific context.
`json`
{
"name": "add-memory",
"arguments": {
"content": "User prefers dark mode interface",
"userId": "user123"
}
}
Search through stored memories to retrieve relevant information.
`json`
{
"name": "search-memories",
"arguments": {
"query": "What are the user's interface preferences?",
"userId": "user123"
}
}
`json`
{
"content": [
{
"type": "text",
"text": "Memory added successfully"
}
],
"isError": false
}
`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
}
- MEM0_API_KEY: Your Mem0 API key (required)
- Required for operation
- Can be obtained from Mem0 Dashboard
- Node.js (v14 or higher)
- A Mem0 API key
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
To run the server in development mode:
`bash`
npm run dev
To build the project:
`bash`
npm run build
To start the server after building:
`bash`
npm start
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
}
Contributions are welcome! Please feel free to submit a Pull Request.
MIT