1. Prepare your account and store
Sign in to OAK and prepare a store. Keep using your existing account if you have one. Connection menus may depend on your AI plan and organization policy.
Sign in to OAK2A. Connect in the desktop app
Open Settings → MCP servers → Add server. Use oak-memory as the name, Streamable HTTP as the transport, and the address below. Save, Restart, then select Authenticate to sign in. Menu names may vary by app version.
https://www.openaikits.com/api/mcp2B. Connect in the CLI
Run these commands in order. If the name already exists, inspect codex mcp list first and preserve its configuration. Sign in to OAK in the browser opened by the login command. The app and CLI share local connection settings; configure only one.
codex mcp add oak-memory --url https://www.openaikits.com/api/mcp
codex mcp login oak-memory3. Choose your store and permissions
When OAK opens, sign in to your own account. Select a store and start with read access. To save or edit memories in Codex, explicitly consent to write access too. Return to Codex after consent and finish installation and connection. Enter your password only on the OAK sign-in page.
4. Check the connection with a real request
In a new chat, use /mcp to check that OAK memory is enabled, then send the prompt below. Confirm the store and memory list through real tool calls.
In connected OAK memory, use currentMemoryStore to check the store name and my permissions, then listMemories to show the memory list. Do not use semantic search or write tools.If something does not work
If Authenticate remains, first try an actual lookup in a new chat. If that fails too, authenticate again in the app or run codex mcp login oak-memory. Consult the official guide if your app version or organization policy changes the menus.
Change or disconnect your store
Revoke access in OAK connection settings. To switch stores or add write access, reconnect and consent to the intended store and permissions. Listing memories and checking the store do not use embedding credits. Semantic recall and saving memories require credits.