# mnemoverse/mcp-memory-server [Health: Active]
**Category:** ๐ง Knowledge & Memory
**Repository:** https://github.com/mnemoverse/mcp-memory-server
**GitHub Stars:** 21
**Views:** 2
**Installs:** 0
**Upvotes:** 0
**Directory Page:** https://allmcps.com/mcp/mnemoverse-mcp-memory-server
## Description
Hosted memory that learns and forgets โ feedback re-ranks what helps, recall fades by recency, similar memories consolidate. One key across Claude, Cursor, VS Code & ChatGPT.
## Tools
Capabilities this server exposes over MCP:
- **memory_write** โ Store a memory โ insight, preference, lesson learned
- **memory_read** โ Search memories by natural language query (optional recency ordering, time bounds, author exclusion)
- **memory_list_recent** โ List newest memories first โ no query; `since`/`until` bounds (inclusive) + cursor paging
- **memory_feedback** โ Rate memories as helpful or not (improves future recall)
- **memory_stats** โ Check how many memories stored, which domains exist
- **memory_create_room** โ Create a shared memory room; its address works as a `domain` on write/read
- **memory_invite_to_room** โ Mint a one-time invite (code + link) for a room you own
- **memory_join_room** โ Join a shared room with an invite code (`mnvr_...`)
- **memory_list_rooms** โ List rooms you own or joined, with each room's address to use as `domain
- **vault_list** โ List Vault secrets by alias and purpose โ the secret value is never returned
## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):
```json
"mcpServers": {
"mcp-memory-server": {
"command": "npx",
"args": ["-y","@mnemoverse/mcp-memory-server@latest"],
"env": {
"MNEMOVERSE_API_KEY": "",
"MNEMOVERSE_API_URL": ""
}
}
}
```
**Requires environment variables:** `MNEMOVERSE_API_KEY`, `MNEMOVERSE_API_URL` โ the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).
## Documentation & README
# Mnemoverse Memory
`@mnemoverse/mcp-memory-server` โ the MCP server for the Mnemoverse memory engine.
[](https://www.npmjs.com/package/@mnemoverse/mcp-memory-server)
[](https://www.npmjs.com/package/@mnemoverse/mcp-memory-server)
[](https://registry.modelcontextprotocol.io/v0/servers?search=mnemoverse)
[](https://opensource.org/licenses/MIT)
[](https://arxiv.org/abs/2603.08965)
[](https://glama.ai/mcp/servers/mnemoverse/mcp-memory-server)
## What is Mnemoverse Memory?
Mnemoverse is a hosted memory engine for AI agents, reached over the Model Context Protocol. Mnemoverse stores what your agents learn โ decisions, preferences, lessons โ and returns it in any connected tool, so one memory follows you across Claude Code, Cursor, VS Code and ChatGPT with a single API key. Mnemoverse re-ranks recall from outcomes: report that a recalled memory helped and a Rescorla-Wagner update on the prediction error raises it, report that it misled and it sinks โ a different mechanism from similarity scoring, usable alongside it.
## How it compares
Most agent memory today lives in one of three places. Per-tool instruction files โ `CLAUDE.md`, `.cursorrules`, `AGENTS.md` โ are versioned and readable, but each copy belongs to one repo and one tool, and nothing follows you to the next window. A vector store behind RAG retrieves by similarity, and similarity never changes because advice helped or misled. Local-first memory servers win on privacy and latency, and ask you to run and update the infrastructure yourself. Mnemoverse is the managed, cross-tool option in that landscape: nothing to deploy, one key everywhere, and ranking that moves with reported outcomes. If you need memory inside your own perimeter, a local-first server is the better choice โ this one is hosted by design.
The consolidation stage of the engine โ HDBSCAN clustering with Von Restorff protection, so distinctive memories are not absorbed into the average โ is designed in and currently switched off on the hosted service; our docs say so rather than hide it.
> โญ If Mnemoverse saves you from re-explaining context to your agents, [star the repo](https://github.com/mnemoverse/mcp-memory-server). It helps other builders find it.
## Quick Start
### 1. Get a free API key
Sign up at [console.mnemoverse.com](https://console.mnemoverse.com?utm_source=npm&utm_medium=readme&utm_campaign=mcp-memory-server) โ takes 30 seconds, no credit card.
### 2. Connect to your AI tool
The two canonical setups, Claude Code and Cursor. Each writes the key **once, at user scope, covering every project**. Avoid a per-project config file for this: it lives inside the repository and can be committed with it, and a key belongs outside:
**Claude Code** โ add via CLI:
```bash
claude mcp add mnemoverse -s user \
-e MNEMOVERSE_API_KEY=mk_live_YOUR_KEY \
-e MNEMOVERSE_API_URL=https://core.mnemoverse.com/api/v1 \
-- npx -y @mnemoverse/mcp-memory-server@latest
```
On Windows (PowerShell), paste the same command as one line โ PowerShell does not read the `\` line continuations:
```powershell
claude mcp add mnemoverse -s user -e MNEMOVERSE_API_KEY=mk_live_YOUR_KEY -e MNEMOVERSE_API_URL=https://core.mnemoverse.com/api/v1 -- npx -y @mnemoverse/mcp-memory-server@latest
```
**Cursor** โ click to install, or add the JSON below to `~/.cursor/mcp.json`, the global config that covers every project. Do not put it in a project-level `.cursor/mcp.json`: that file lives inside the repository and is committed with it unless you exclude it, and this config holds your key.
[](https://cursor.com/en/install-mcp?name=mnemoverse&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtbmVtb3ZlcnNlL21jcC1tZW1vcnktc2VydmVyQGxhdGVzdCJdLCJlbnYiOnsiTU5FTU9WRVJTRV9BUElfS0VZIjoibWtfbGl2ZV9ZT1VSX0tFWSIsIk1ORU1PVkVSU0VfQVBJX1VSTCI6Imh0dHBzOi8vY29yZS5tbmVtb3ZlcnNlLmNvbS9hcGkvdjEifX0%3D)
The install button carries the placeholder key `mk_live_YOUR_KEY`, not yours, so the shortest path is to skip the button: add the JSON below to `~/.cursor/mcp.json`, merging it with any servers already there, and put your own key in place. Get one at [console.mnemoverse.com](https://console.mnemoverse.com?utm_source=npm&utm_medium=readme&utm_campaign=mcp-memory-server). If you did click the button, edit the same key in the `mcp.json` it wrote; Cursor keeps MCP environment values in that file, not in a settings form. Until the key is real the server starts and lists its tools, but every tool call is refused.
```json
{
"mcpServers": {
"mnemoverse": {
"command": "npx",
"args": [
"-y",
"@mnemoverse/mcp-memory-server@latest"
],
"env": {
"MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
"MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
}
}
}
}
```
All other clients โ VS Code, Windsurf, Zed, JetBrains, Cline, Continue
**VS Code** โ add to `.vscode/mcp.json` (note: VS Code uses `servers`, not `mcpServers`). That file is meant to be committed and shared with your team, so the key in it is too โ if you'd rather keep it out of the repo, run **MCP: Open User Configuration** from the Command Palette and add the same JSON to your user profile's `mcp.json` instead:
```json
{
"servers": {
"mnemoverse": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mnemoverse/mcp-memory-server@latest"
],
"env": {
"MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
"MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
}
}
}
}
```
**Windsurf** โ add to `~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"mnemoverse": {
"command": "npx",
"args": [
"-y",
"@mnemoverse/mcp-memory-server@latest"
],
"env": {
"MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
"MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
}
}
}
}
```
**More MCP clients** โ same server, different config file:
**Zed** โ add to `~/.config/zed/settings.json` (Zed uses `context_servers`, and `"source": "custom"` is required):
```json
{
"context_servers": {
"mnemoverse": {
"source": "custom",
"command": "npx",
"args": [
"-y",
"@mnemoverse/mcp-memory-server@latest"
],
"env": {
"MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
"MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
}
}
}
}
```
**JetBrains** (AI Assistant) โ *Settings โ Tools โ AI Assistant โ Model Context Protocol (MCP)*, then paste:
```json
{
"mcpServers": {
"mnemoverse": {
"command": "npx",
"args": [
"-y",
"@mnemoverse/mcp-memory-server@latest"
],
"env": {
"MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
"MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
}
}
}
}
```
**Cline** โ *MCP Servers โ Configure* (or edit `cline_mcp_settings.json`). Cline reads `env` values literally, so paste your real key โ not a `${VAR}` reference:
```json
{
"mcpServers": {
"mnemoverse": {
"command": "npx",
"args": [
"-y",
"@mnemoverse/mcp-memory-server@latest"
],
"env": {
"MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
"MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
}
}
}
}
```
**Continue** โ add `~/.continue/mcpServers/mnemoverse.yaml` (Continue uses YAML):
```yaml
mcpServers:
- name: mnemoverse
command: npx
args:
- "-y"
- "@mnemoverse/mcp-memory-server@latest"
env:
MNEMOVERSE_API_KEY: "mk_live_YOUR_KEY"
MNEMOVERSE_API_URL: "https://core.mnemoverse.com/api/v1"
```
> Why `@latest`? Bare `npx @mnemoverse/mcp-memory-server` is cached indefinitely by npm and stops re-checking the registry. The `@latest` suffix forces a metadata lookup on every Claude Code / Cursor / VS Code session start (~100-300ms), so you always pick up new releases.
> โ ๏ธ **Restart your AI client** after editing the config. MCP servers are only picked up on client startup.
### 3. Try it โ 30 seconds to verify it works
Paste this in your AI chat:
> **"Remember that my favourite TypeScript framework is Hono, and please call `memory_write` to save it."**
Your agent should call `memory_write` and confirm the memory was stored.
Then open a **new chat / new session** (this is the whole point โ memory survives restarts), and ask:
> **"What's my favourite TypeScript framework?"**
Your agent should call `memory_read`, find the entry, and answer "Hono". If it does โ you're wired up. Write whatever you want next.
If it doesn't remember: check that the client was fully restarted and the config has your real `mk_live_...` key, not the placeholder.
## Tools
| Tool | What it does |
|------|-------------|
| `memory_write` | Store a memory โ insight, preference, lesson learned |
| `memory_read` | Search memories by natural language query (optional recency ordering, time bounds, author exclusion) |
| `memory_list_recent` | List newest memories first โ no query; `since`/`until` bounds (inclusive) + cursor paging |
| `memory_feedback` | Rate memories as helpful or not (improves future recall) |
| `memory_stats` | Check how many memories stored, which domains exist |
| `memory_create_room` | Create a shared memory room; its address works as a `domain` on write/read |
| `memory_invite_to_room` | Mint a one-time invite (code + link) for a room you own |
| `memory_join_room` | Join a shared room with an invite code (`mnvr_...`) |
| `memory_list_rooms` | List rooms you own or joined, with each room's address to use as `domain` |
| `vault_list` | List Vault secrets by alias and purpose โ the secret value is never returned |
## Use cases
The pattern that pays off first is cross-tool continuity: a decision made while pairing in Claude Code is there when you open Cursor an hour later, and the preference you stated in VS Code holds in a ChatGPT session that evening. Teams use shared rooms the same way โ one place where an agent's lessons about a codebase accumulate instead of being re-taught per seat. And because recall re-ranks from feedback, the memories that keep proving useful surface first, which matters once a store grows past what anyone curates by hand.
Concrete things worth writing:
- **User preferences**: "I use dark mode", "I prefer Tailwind over CSS modules"
- **Project context**: "This project uses PostgreSQL + Prisma", "Deploy to Railway"
- **Lessons learned**: "Always run tests before push on this repo"
- **Decisions made**: "We chose REST over GraphQL because of caching simplicity"
- **People & roles**: "Alice is the designer, Bob owns the API"
- **Past mistakes**: "Don't deploy on Fridays โ learned this the hard way"
## Universal Memory
The same API key works across all tools. Write a memory in Claude Code โ read it in Cursor. Learn something in VS Code โ your GPT Custom Action knows it too.
```
โโโ Claude Code (this MCP server)
โโโ Cursor (this MCP server)
Mnemoverse API โโโโโ VS Code (this MCP server)
(one memory) โโโ GPT (Custom Actions)
โโโ Python SDK (pip install mnemoverse)
โโโ REST API (curl)
```
## Configuration
| Env Variable | Required | Default |
|-------------|----------|---------|
| `MNEMOVERSE_API_KEY` | For every tool call โ the server starts and lists its tools without one | โ |
| `MNEMOVERSE_API_URL` | No | `https://core.mnemoverse.com/api/v1` |
## Research behind it
The retrieval model is published: [arXiv:2603.08965](https://arxiv.org/abs/2603.08965), accepted at the GRAAI workshop at IEEE WCCI 2026 โ it establishes the abstraction-discovery method the memory model builds on. No benchmark figures appear in this README, ours or anyone's: numbers will come with a reproducible run to stand behind, not before.
## Links
**Setup and reference**
- [Documentation](https://mnemoverse.com/docs/api/mcp-server)
- [Cursor](https://mnemoverse.com/docs/api/cursor) ยท [VS Code](https://mnemoverse.com/docs/api/vs-code) ยท [Claude Code](https://mnemoverse.com/docs/api/claude) ยท [ChatGPT](https://mnemoverse.com/docs/api/chatgpt)
- [Python SDK](https://mnemoverse.com/docs/api/python-sdk)
- [API Reference](https://mnemoverse.com/docs/api/reference)
- [Console (get API key)](https://console.mnemoverse.com?utm_source=npm&utm_medium=readme&utm_campaign=mcp-memory-server)
**Background reading**
- [Memory MCP servers compared](https://mnemoverse.com/docs/library/memory-mcp-servers-compared) โ thirteen shipping options, with pricing and registry presence
- [How to choose a memory MCP server](https://mnemoverse.com/docs/library/memory-mcp) โ the five questions that narrow the field
- [What AI agent memory is](https://mnemoverse.com/docs/library/ai-agent-memory) โ the category explained
- [Is this a vector database?](https://mnemoverse.com/docs/library/not-a-vector-database) โ what makes a memory layer different
- [Shared memory for multi-agent systems](https://mnemoverse.com/docs/library/shared-memory-for-multi-agent-systems) โ how Rooms work and when to use them
**Other ways to install it**
The same memory, packaged for hosts that prefer a plugin or an extension over an MCP config block. How each one connects and authenticates differs, so the line below says which is which rather than claiming one flow for all of them.
- [Claude Code plugin](https://github.com/mnemoverse/claude-plugin) โ remote endpoint over MCP with an OAuth sign-in, no key to paste. Bundles the `agent-memory-discipline` skill
```
claude plugin marketplace add mnemoverse/claude-plugin
claude plugin install mnemoverse@mnemoverse
```
- [Cursor plugin](https://github.com/mnemoverse/cursor-plugin) โ same remote endpoint, same sign-in
- [Gemini CLI extension](https://github.com/mnemoverse/gemini-extension) โ same remote endpoint. `gemini extensions install https://github.com/mnemoverse/gemini-extension`
- [VS Code extension](https://github.com/mnemoverse/mnemoverse-vscode) โ signs in through the browser, with pasting a key kept as a fallback command
- Desktop extension: `manifest.json` in this repository is an MCPB manifest. This one is different from the four above: it runs the server as a local `node` process and reads `MNEMOVERSE_API_KEY` from the extension settings rather than calling the hosted endpoint. The packaged `.mcpb` ships with each release
**Standing rules, separate from this server**
- [agent-memory-discipline](https://github.com/mnemoverse/agent-memory-discipline) โ when an agent should recall before acting and save afterward. CC0, backend-neutral, works against any memory store rather than this one. It carries its own [marketplace manifest](https://github.com/mnemoverse/agent-memory-discipline/blob/main/.claude-plugin/marketplace.json) under `.claude-plugin/`.
- [awesome-agent-memory](https://github.com/mnemoverse/awesome-agent-memory) โ a curated index of the category, CC0, including the servers this one competes with
**Project**
- [GitHub](https://github.com/mnemoverse/mcp-memory-server)
- [Releases](https://github.com/mnemoverse/mcp-memory-server/releases)
- [MCP Registry entry](https://registry.modelcontextprotocol.io/v0/servers?search=mnemoverse)
- [Contributing](https://github.com/mnemoverse/mcp-memory-server/blob/HEAD/CONTRIBUTING.md)
## Privacy Policy
This server sends to the Mnemoverse API (`core.mnemoverse.com`), authenticated with your API key, what a tool call carries โ and nothing else it can see. It does **not** read your AI client's conversation history, your local files, or anything you don't pass to a `memory_*` / `vault_*` tool. Stored memories live under your account; Mnemoverse never sells them and never shares them on its own. The one sharing path is the one you create yourself: inviting someone to a shared room grants their assistant access to that room's memories, bounded by the invite's scope.
What each tool sends:
| Tool | Data sent |
|---|---|
| `memory_write` | the `content`, `concepts`, and `domain` you pass |
| `memory_read` | the `query`, plus any filters: `domain`, `since`/`until`, `exclude_author`, `top_k`, `order_by` |
| `memory_list_recent` | the feed filters: `domain`, `since`/`until`, `exclude_author`, `limit`, `cursor` |
| `memory_feedback` | the `atom_ids` being rated and the `outcome` score |
| `memory_create_room` | the room `name` and `description` |
| `memory_invite_to_room` | the `room_id`, invite `scope`, and expiry |
| `memory_join_room` | the invite `code` |
| `memory_stats` / `memory_list_rooms` / `vault_list` | no request body โ authenticated GETs |
One thing goes out that you did not explicitly request: since 0.8.1, when a search or feed comes back empty, the server sends one or two authenticated read-only GET probes (`/memory/rooms` and/or `/memory/stats`) so the empty answer can say what it did not cover. The probes carry your API key and nothing else, change no stored state, and are disclosed in the [CHANGELOG](https://github.com/mnemoverse/mcp-memory-server/blob/HEAD/CHANGELOG.md).
| | |
|---|---|
| **Privacy Policy** | |
| **Retention & deletion** | correct a wrong or stale memory by writing a fresh one; deletion is an administrative operation on the REST API, not exposed through this MCP server |
| **Contact** | hello@mnemoverse.com |
## License
[MIT](https://github.com/mnemoverse/mcp-memory-server/blob/HEAD/LICENSE) ยฉ Mnemoverse