@mem0/mcp-server

Mem0 Memory MCP Server

A 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.

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

Running with npx

env MEM0_API_KEY=your-api-key-here npx -y @mem0/mcp

Manual Installation

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:

{
  "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:

{
  "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.

{
  "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.

{
  "name": "search-memories",
  "arguments": {
    "query": "What are the user's interface preferences?",
    "userId": "user123"
  }
}

Response Format

Add Memory Response

{
  "content": [
    {
      "type": "text",
      "text": "Memory added successfully"
    }
  ],
  "isError": false
}

Search Memory Response

{
  "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

Development

Prerequisites

• Node.js (v14 or higher)
• A Mem0 API key

Setup

1. Clone the repository
2. Install dependencies:

npm install

3. Create a .env file in the root directory and add your Mem0 API key:

MEM0_API_KEY=your-api-key-here

Running Development Server

To run the server in development mode:

npm run dev

Building

To build the project:

npm run build

Starting the Server

To start the server after building:

npm start

Error Handling

The server includes error handling for:

• API connection issues
• Invalid memory operations
• Search errors
• Authentication failures

Example error response:

{
  "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