XMemo gives Gemini CLI a persistent, user-owned long-term memory. Store and recall facts, preferences, decisions, and project context across sessions — and share the same memory with every AI tool you use (ChatGPT, Claude, Copilot, IDEs, and more).
XMemo is user-owned: you control, view, edit, and delete your memories at xmemo.dev.
gemini extensions install https://github.com/yonro/xmemo-gemini-cliAfter installing, restart your Gemini CLI session so the extension loads.
XMemo uses automatic OAuth. The first time the memory_os tools are used,
Gemini CLI detects the 401 from https://xmemo.dev/mcp, discovers XMemo's OAuth
endpoints, registers a client, and opens your browser to sign in. Your tokens are
stored securely by Gemini CLI for future sessions — no API key to copy or paste.
Prefer an API token instead? You can add
"Authorization": "Bearer <token>"to theheadersblock manually, but OAuth is the recommended, zero-secret path.
- A
memory_osMCP server connected tohttps://xmemo.dev/mcp. - Tools to search, add, and update memories from inside Gemini CLI.
- A
GEMINI.mdplaybook that teaches the model when to store and recall memories.
| Field | Value |
|---|---|
| Transport | Remote HTTP MCP (httpUrl) |
| Endpoint | https://xmemo.dev/mcp |
| Auth | Automatic OAuth 2.0 (RFC 9728 discovery + dynamic client registration + PKCE) |
| Agent label | X-Memory-OS-Agent-ID: gemini-cli (so memories are attributed to this client) |
OAuth authenticates you (the memory owner). The X-Memory-OS-Agent-ID header is
a label that tells XMemo which client wrote a memory — it is attribution, not a
security boundary. Your OAuth identity is the security boundary.
gemini extensions list
gemini extensions update xmemo
gemini extensions disable xmemo
gemini extensions uninstall xmemo- Authentication uses OAuth; tokens are managed by Gemini CLI, not stored in this repo.
- No host environment variables are forwarded to the server.
- You can delete any memory at any time from xmemo.dev.
- Website: https://xmemo.dev
- MCP endpoint: https://xmemo.dev/mcp
MIT — see LICENSE.