XMemo — Claude Code MCP server: what it does, how to install
Persists facts, decisions, and task lists across coding sessions through local stdio or hosted MCP endpoints.
claude mcp add --env XMEMO_KEY=<XMEMO_KEY> --env XMEMO_URL=<XMEMO_URL> --transport stdio xmemo -- npx -y @xmemo/clientWhat XMemo does
XMemo provides a persistent context layer for development agents. It tracks project facts, pending tasks, and architectural decisions, returning relevant details within specified token limits. The system stamps memory entries with agent identity to preserve origin records.
Running the local CLI runner requires Node.js version 20 or newer. While the @xmemo/client library is published under the MIT license, the hosted backend remains private. A valid XMEMO_KEY token is required to establish communication with the storage layer.
What it helps with
- persist project state and task lists across agent reboots
- share memory across editors and terminal clients
- retrieve scoped context under tight token budgets
- track record origins by tagging specific agent instances
Example prompts for the agent
- Save our module architecture decisions to XMemo
- Fetch project tasks and past architectural decisions from XMemo
How to install XMemo
1Platform CLI
claude mcp add --env XMEMO_KEY=<XMEMO_KEY> --env XMEMO_URL=<XMEMO_URL> --transport stdio xmemo -- npx -y @xmemo/clientReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http xmemo https://xmemo.dev/mcp1Platform CLI: remote server
codex mcp add xmemo --url https://xmemo.dev/mcp2Platform CLI
codex mcp add xmemo --env XMEMO_KEY=<XMEMO_KEY> --env XMEMO_URL=<XMEMO_URL> -- npx -y @xmemo/clientReplace <…> with your own values
Config file
{
"mcpServers": {
"xmemo": {
"url": "https://xmemo.dev/mcp"
}
}
}{
"mcpServers": {
"xmemo": {
"command": "npx",
"args": [
"-y",
"@xmemo/client"
],
"env": {
"XMEMO_KEY": "<XMEMO_KEY>",
"XMEMO_URL": "<XMEMO_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"xmemo": {
"type": "http",
"url": "https://xmemo.dev/mcp"
}
}
}{
"servers": {
"xmemo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xmemo/client"
],
"env": {
"XMEMO_KEY": "<XMEMO_KEY>",
"XMEMO_URL": "<XMEMO_URL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http xmemo https://xmemo.dev/mcp2Platform CLI
gemini mcp add -e XMEMO_KEY=<XMEMO_KEY> -e XMEMO_URL=<XMEMO_URL> xmemo npx -y @xmemo/clientReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about XMemo
How to install XMemo in Claude Code?
Run claude mcp add xmemo -e XMEMO_KEY=<XMEMO_KEY> -- npx -y @xmemo/client. This configures the local stdio runner with your access key.
What does XMemo do?
It functions as an external memory system that stores agent context, preferences, and session progress. Data can be reached via MCP, REST calls, or the command line.
What runtime dependencies does local operation require?
You need Node.js 20 or later installed on the host. You also need an XMEMO_KEY token set in the environment.
