Mem0 General

by ryaker

406 downloads

Not rated

GitHub

About

OpenAI just added memory across your chats across your openAI account. But wouldn't it be awesome to have general AI memory across all your interactions with any and all AI tools, IDEs, chatbots.... Now if it supports MCP you can with https://mem0.ai/ Give Claude desktop memory.

Details

Author: ryaker
Downloads: 406
Categories: AI

- Modular architecture for maintainability and extensibility
- Short-term memories: conversation, working, attention
- Long-term memories: episodic, semantic, procedural
- Semantic similarity search across stored memories
- Custom memory categories and processing instructions
- Selective memory filtering with include/exclude patterns

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Mem0 General

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

From the repository

Install the package with pip install mcp-mem0-server, then add a configuration entry to your MCP config file (e.g., ~/.cursor/mcp.json) that sets the MEM0_API_KEY environment variable and runs the command mcp-mem0-server. After restarting the client application (Cursor or Claude Desktop), the server tools are available.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mem0 general": {
            "mem0-memory-general": {
                "command": "<PATH TO SERVER>/mcp-mem0-server",
                "args": [],
                "env": {
                    "MEM0_API_KEY": "<YOUR MEM0 KEY>"
                }
            }
        }
    }
}

McpServers

{
    "mem0-memory-general": {
        "command": "<PATH TO SERVER>/mcp-mem0-server",
        "args": [],
        "env": {
            "MEM0_API_KEY": "<YOUR MEM0 KEY>"
        }
    }
}

Mem0 MCP Server

A Model Context Protocol (MCP) server for integrating AI assistants with Mem0.ai's persistent memory system.

Overview

This server provides MCP-compatible tools that let any compatible AI assistant access and manage persistent memories stored in Mem0. It acts as a bridge between AI models and the Mem0 memory system, enabling assistants to:

- Store and retrieve memories
- Search memories with semantic similarity
- Manage different memory types (episodic, semantic, procedural)
- Utilize short-term memory for conversation context
- Apply selective memory patterns
- Create knowledge graphs from memories

Project Structure

The project has been refactored from a monolithic design to a modular structure:

mem0_mcp_server/ ├── core/ # Core functionality │ ├── client.py # Mem0 client initialization │ ├── logging.py # Logging configuration │ └── server.py # MCP server setup ├── operations/ # Basic memory operations │ └── basic.py # Add, search, get, delete, update ├── memory_types/ # Specialized memory implementations │ ├── short_term.py # Conversation, working, attention │ └── specialized.py # Episodic, semantic, procedural └── advanced/ # Advanced features ├── features.py # Categories, instructions, graph, feedback └── selective.py # Pattern-based memory filtering

app.py # Main entry point

Getting Started

Setting up in Cursor or Claude Desktop

1. Install the package:

pip install mcp-mem0-server

2. Add the following configuration to your MCP configuration file:

For Cursor, add this to ~/.cursor/mcp.json:

"mem0-memory-general": {

  "command": "mcp-mem0-server",

  "args": [],

  "env": {

    "MEM0_API_KEY": "your-mem0-api-key-here"

  }

}

For Claude Desktop, add a similar configuration in your settings.

3. Restart Cursor or Claude Desktop to apply the changes.

Memory Types

The server supports different memory types organized by duration and function:

Short-Term Memories

- Conversation Memory: Recall of recent message exchanges - Working Memory: Temporary information being actively used - Attention Memory: Information currently in focus

Long-Term Memories

- Episodic Memory: Specific events and experiences - Semantic Memory: Facts, concepts, and knowledge - Procedural Memory: Skills and how-to information

Advanced Features

- Custom Categories: Define and manage your own memory categories
- Memory Instructions: Set guidelines for how memories should be processed
- Graph Relations: Access knowledge graph relationships between entities
- Selective Memory: Filter text with include/exclude patterns before storing
- Feedback Mechanism: Provide feedback on memory quality

Usage

All memories in the system use "default_user" as the default user_id.

For detailed usage examples, see the USAGE_GUIDE.md.

Documentation

- Getting Started
- API Reference
- Memory Types
- Advanced Features
- Configuration

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

- Mem0.ai for their excellent memory API
- FastMCP for the MCP server implementation
- All contributors to this project

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Mem0 MCP Server

Overview

Project Structure

Getting Started

Setting up in Cursor or Claude Desktop

Memory Types

Short-Term Memories

Long-Term Memories

Advanced Features

Usage

Documentation

License

Acknowledgments

Install

More like this

Context 7

1Panel

🔎 GPT Researcher

Serena

FastMCP v2 🚀

MaxKB