Docs - OneMemory

1. Install

Run OneMemory-Setup.exe. It installs per-user (no admin prompt) and starts the tray app. A green OneMemory icon appears in your system tray.

2. First-run wizard

Data folder. Your memories live in %LOCALAPPDATA%\OneMemory, only on this machine.
Observer consent. Off by default. Turn it on if you want OneMemory to watch your AI session files and propose memories automatically. You can flip this anytime from the tray menu.
Connect your AI tools. Detected tools are pre-checked. OneMemory adds itself as an MCP server; your existing settings are backed up first.

3. Verify each client

Claude Code

Open a new session and run a prompt like "what do you remember about me?" Claude Code should call the onememory MCP tools. You can also check /mcp for the server entry.

Claude Desktop

Restart Claude Desktop after the wizard. The tools icon should list onememory.

Cursor

Settings, MCP: onememory should show as connected after a restart.

Codex

New sessions pick up [mcp_servers.onememory] from ~/.codex/config.toml automatically.

4. Your first memory

Tell any connected AI something durable: "remember that our staging deploys run from the release branch." It proposes a memory; sensitive items wait in the approval queue. Click the tray icon to open the dashboard and approve. Now ask a different AI tool about deploys: it recalls what the first one learned.

Where things live

%LOCALAPPDATA%\OneMemory\
  onememory.sqlite3    your memory database
  config.env           local settings + API key
  logs\                server, observer, tray logs
  backups\             local backups

Troubleshooting

Tray says offline. Right-click the tray icon, Quit, then start OneMemory again from the Start Menu. Check logs\server.err.log.
A client doesn't see the tools. Restart that client; MCP servers load at startup. Re-run wiring anytime by deleting .setup-complete in the data folder and relaunching.
Port conflict. OneMemory uses 127.0.0.1:8787. Set ONEMEMORY_PORT in config.env and restart if something else owns it.
Export everything. The dashboard's export gives you your full database in open formats. It works with or without a subscription.

Support

Email hello@onememoryai.com. Include logs\ files if it's a crash; they never contain your memory contents.

Quickstart