---
title: "Set up server-memory MCP in Claude Desktop | Bombos"
description: "Configure @modelcontextprotocol/server-memory in Claude Desktop with npx or Docker, then restart. Use MEMORY_FILE_PATH to keep the graph outside npm."
image: "https://bombos.ai/assets/og-en-v2.png"
---

# How do I set up the official MCP memory server (server-memory) in Claude Desktop?

Short answer

Add the server to Claude Desktop's mcpServers config with npx -y @modelcontextprotocol/server-memory (Node.js 24 or later) or the mcp/memory Docker image, then restart Claude. Set MEMORY\_FILE\_PATH to an absolute path you own, such as ~/memory.jsonl, because the default file sits inside the package folder and can disappear on an update.

*Piet Baudoin · published November 16, 2026 · November 16, 2026*

## Setup in five steps

1.  **Install Node.js 24 or later** if you use npx. The README lists that as the requirement. Docker users can skip this.
2.  **Open the Claude Desktop config file**: `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `%APPDATA%\Claude\claude_desktop_config.json` on Windows. In Claude Desktop you can also reach it through Settings, Developer, Edit Config. Merge the memory entry into any existing `mcpServers` object instead of replacing it.
3.  **Add the server** under `mcpServers`:

```
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": { "MEMORY_FILE_PATH": "/Users/you/memory.jsonl" }
    }
  }
}
```

On Windows, use `"command": "cmd"` with args `["/c", "npx", "-y", "@modelcontextprotocol/server-memory"]` and a Windows path such as `"%USERPROFILE%\\memory.jsonl"` (backslashes doubled in JSON).

4.  **Or use Docker** instead of npx:

```
"memory": {
  "command": "docker",
  "args": ["run", "-i", "-v", "claude-memory:/app/dist", "--rm", "mcp/memory"]
}
```

Note that this volume sits over the image’s code folder, so it holds the server code next to `memory.jsonl`. A newer image does not reach a volume that is already filled; the README describes how to copy the new code into the volume when you upgrade, keeping your graph.

5.  **Quit Claude Desktop completely and reopen it.** Closing the window is not enough; quit it from the menu bar or system tray. Then test: ask Claude to store a test fact, start a fresh chat and ask it to retrieve that fact explicitly. Open the memory file to confirm the line was written. If a call fails or the tools do not appear, check the MCP logs (`~/Library/Logs/Claude/` on macOS, `%APPDATA%\Claude\logs\` on Windows).

## The one setting people miss: MEMORY\_FILE\_PATH

Without it, the server writes `memory.jsonl` into its own folder. Under npx that folder is inside `node_modules`, and the README warns that a reinstall, an update or clearing the cache can delete your graph. It logs a warning on startup when the path is inside `node_modules`. Set an absolute path you own. A leading `~` expands to your home folder; relative paths resolve against the server folder, and the parent folder must exist.

## What you get

| Tool | What it does |
| --- | --- |
| create\_entities | Adds people, projects, companies as nodes |
| create\_relations | Links two entities, e.g. “Anna works\_on Project X” |
| add\_observations | Adds facts to an entity |
| delete\_entities / delete\_observations / delete\_relations | Removes data |
| read\_graph | Returns the whole graph |
| search\_nodes | Searches names, types and observations |
| open\_nodes | Fetches specific entities by name |

There is also a resource, `memory://knowledge-graph`, that mirrors the whole graph.

## Make Claude actually use it

Installing the server does not make Claude check it. The client must retrieve memory and put it in context, for example through `search_nodes`, `open_nodes`, `read_graph` or the knowledge-graph resource. Add a line to your Project instructions or system prompt, for example: “At the start of each conversation, search memory for relevant entities. When you learn a lasting fact about me or my work, store it.” Then test it in a fresh chat.

## The misunderstanding: this is not team memory

server-memory is a teaching example. It is local, it runs per user, it has no accounts, roles or audit trail, and the repository says it is not production-ready. Several Claude windows on the same machine can write to one file (the server uses a lock file), and other local MCP clients can share the graph when configured with the same `MEMORY_FILE_PATH`. But your colleagues’ Claude, and any cloud tool that cannot reach the file, see nothing, and there are no team accounts or permissions.

For the concept behind memory servers, see [what an MCP memory server is](https://bombos.ai/en/questions/mcp/what-is-an-mcp-memory-server/). For a hosted alternative, compare [the Mem0 MCP server](https://bombos.ai/en/questions/mcp/mem0-mcp-server-vs-shared-team-memory/).

## Where Bombos fits

server-memory is a good way to see how MCP memory feels on your own machine. Bombos is the step after that: a plugin that gives every AI tool your team uses, from Claude Desktop to ChatGPT, Copilot and Cursor, one shared memory with team knowledge, learned rules and what already sits in mail, documents and repos, and that shows what each answer rests on. You can start alone with your own agents, in our cloud or on your own server.

## Related questions

Where does server-memory store its data?

In a JSONL file. The default is memory.jsonl in the server's own folder; with MEMORY\_FILE\_PATH you point it to any absolute path. The parent folder must already exist.

Can I add server-memory as a custom connector on claude.ai?

Not as is. Custom connectors on claude.ai need a remote server reachable over HTTPS from the internet. server-memory is a local stdio server meant for clients like Claude Desktop that start it on your machine.

Can two people share the same memory.jsonl?

The README says locking relies on exclusive file creation and that a network file system without it is not safe for sharing. It is built for one machine, not for a team.

Is server-memory production-ready?

The MCP servers repository calls its servers reference implementations, meant to show how MCP works, and says they are not intended as production-ready solutions.

## Sources

1.  [Knowledge Graph Memory Server README](https://github.com/modelcontextprotocol/servers/tree/main/src/memory)
2.  [Model Context Protocol servers repository](https://github.com/modelcontextprotocol/servers)
3.  [Connect to local MCP servers (MCP documentation)](https://modelcontextprotocol.io/docs/develop/connect-local-servers)
4.  [Get started with custom connectors using remote MCP (Claude Help Center)](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

## What does your AI forget?

1.  01You tell us which AI you use and where it keeps starting over.
2.  02We show what a shared memory changes there, on your own examples.
3.  03You keep the plan, with or without Bombos.

![Piet Baudoin](https://bombos.ai/assets/team/piet-klein.jpg)

**Piet Baudoin**You talk to Piet, from the Bombos teamDutch team from Utrecht and Nijmegen · data in Europe

## More questions about MCP

-   [What is an MCP memory server and how does it work?](https://bombos.ai/en/questions/mcp/what-is-an-mcp-memory-server/)
-   [What is the AWS MCP Server and how do you set it up safely?](https://bombos.ai/en/questions/mcp/aws-mcp-server/)
-   [What is the Datadog MCP server and how do you set it up for a team?](https://bombos.ai/en/questions/mcp/datadog-mcp-server/)
-   [What is the GitHub MCP server and how should a team set it up?](https://bombos.ai/en/questions/mcp/github-mcp-server/)
-   [How do you connect Claude or ChatGPT to Salesforce with an MCP server?](https://bombos.ai/en/questions/mcp/salesforce-mcp-server/)
-   [Is MCP safe to use in a company, and what controls do we need?](https://bombos.ai/en/questions/mcp/is-mcp-safe-to-use-in-a-company/)
-   [How do you connect Jira and Confluence to AI with the Atlassian MCP server?](https://bombos.ai/en/questions/mcp/jira-and-confluence-mcp-server/)
-   [Local vs remote MCP server: which should a team use?](https://bombos.ai/en/questions/mcp/local-vs-remote-mcp-server/)

[All questions about MCP →](https://bombos.ai/en/questions/mcp/)


---

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","url":"https://bombos.ai/","logo":"https://bombos.ai/assets/bombos-bee.png","description":"Bombos is the memory layer under every AI your team uses. One shared memory for Claude, ChatGPT, Copilot, Cursor and your own agents, that learns how you work.","sameAs":["https://www.linkedin.com/company/bombos-ai","https://www.youtube.com/@truebombos","https://www.instagram.com/truebombos/","https://bsky.app/profile/bombostrue.bsky.social","https://www.threads.com/@truebombos","https://mastodon.social/@Bombos","https://www.tiktok.com/@truebombos","https://t.me/truebombos","https://www.pinterest.com/truebombos/","https://github.com/bombos-ai","https://linktr.ee/bombos.ai","https://bombosai.substack.com","https://hashnode.com/@bombosai","https://hackernoon.com/u/bombos","https://dev.to/bombos"],"email":"info@bombos.ai","areaServed":["NL","Europe"],"knowsLanguage":["nl","en"],"contactPoint":{"@type":"ContactPoint","email":"info@bombos.ai","contactType":"sales","url":"https://bombos.ai/en/contact/","availableLanguage":["nl","en"]}},{"@type":"WebSite","@id":"https://bombos.ai/#website","name":"Bombos","url":"https://bombos.ai/","inLanguage":["nl-NL","en"],"publisher":{"@id":"https://bombos.ai/#organization"}}]}

{"@context":"https://schema.org","@type":"Article","headline":"How do I set up the official MCP memory server (server-memory) in Claude Desktop?","description":"Configure @modelcontextprotocol/server-memory in Claude Desktop with npx or Docker, then restart. Use MEMORY_FILE_PATH to keep the graph outside npm.","abstract":"Add the server to Claude Desktop's mcpServers config with npx -y @modelcontextprotocol/server-memory (Node.js 24 or later) or the mcp/memory Docker image, then restart Claude. Set MEMORY_FILE_PATH to an absolute path you own, such as ~/memory.jsonl, because the default file sits inside the package folder and can disappear on an update.","datePublished":"2026-11-16T00:00:00.000Z","dateModified":"2026-11-16T00:00:00.000Z","author":{"@type":"Person","name":"Piet Baudoin"},"publisher":{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","logo":{"@type":"ImageObject","url":"https://bombos.ai/assets/bombos-bee.png"}},"image":"https://bombos.ai/assets/og-en-v2.png","mainEntityOfPage":"https://bombos.ai/en/questions/mcp/how-to-set-up-server-memory-mcp-in-claude/","inLanguage":"en-US","isPartOf":{"@type":"CollectionPage","name":"MCP","url":"https://bombos.ai/en/questions/mcp/"},"citation":[{"@type":"CreativeWork","name":"Knowledge Graph Memory Server README","url":"https://github.com/modelcontextprotocol/servers/tree/main/src/memory"},{"@type":"CreativeWork","name":"Model Context Protocol servers repository","url":"https://github.com/modelcontextprotocol/servers"},{"@type":"CreativeWork","name":"Connect to local MCP servers (MCP documentation)","url":"https://modelcontextprotocol.io/docs/develop/connect-local-servers"},{"@type":"CreativeWork","name":"Get started with custom connectors using remote MCP (Claude Help Center)","url":"https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp"}]}

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Bombos","item":"https://bombos.ai/en/"},{"@type":"ListItem","position":2,"name":"Questions","item":"https://bombos.ai/en/questions/"},{"@type":"ListItem","position":3,"name":"MCP","item":"https://bombos.ai/en/questions/mcp/"},{"@type":"ListItem","position":4,"name":"How do I set up the official MCP memory server (server-memory) in Claude Desktop?","item":"https://bombos.ai/en/questions/mcp/how-to-set-up-server-memory-mcp-in-claude/"}]}

{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Where does server-memory store its data?","acceptedAnswer":{"@type":"Answer","text":"In a JSONL file. The default is memory.jsonl in the server's own folder; with MEMORY_FILE_PATH you point it to any absolute path. The parent folder must already exist."}},{"@type":"Question","name":"Can I add server-memory as a custom connector on claude.ai?","acceptedAnswer":{"@type":"Answer","text":"Not as is. Custom connectors on claude.ai need a remote server reachable over HTTPS from the internet. server-memory is a local stdio server meant for clients like Claude Desktop that start it on your machine."}},{"@type":"Question","name":"Can two people share the same memory.jsonl?","acceptedAnswer":{"@type":"Answer","text":"The README says locking relies on exclusive file creation and that a network file system without it is not safe for sharing. It is built for one machine, not for a team."}},{"@type":"Question","name":"Is server-memory production-ready?","acceptedAnswer":{"@type":"Answer","text":"The MCP servers repository calls its servers reference implementations, meant to show how MCP works, and says they are not intended as production-ready solutions."}}]}
```
