Source: https://mnemoverse.com/docs/api/codex
Content revision: ac19af48eecc92b88dc92313e3e991d4451d813b1785379ac9c4be2813f636e3
Updated: 2026-11-16T22:14:11Z

# Codex: connect Mnemoverse Memory

Keep project decisions, working preferences and lessons between Codex tasks. Connect the same Mnemoverse account you use in ChatGPT or another app to find the notes you have already saved.

**Start by asking Codex**

```text
Help me connect Mnemoverse Memory so I can keep context between chats.
```

Codex can help you choose the setup for your app. In a desktop app with plugins, follow the **Install** or **Connect** prompt when offered. Complete browser sign-in and approve the connection yourself. If you need to set it up manually, choose your environment below.

You do not need to create a Mnemoverse account beforehand. Continue with **Google** or **GitHub** when the sign-in window opens; a new account is created during sign-in. Already use Mnemoverse? Choose **the same account** to keep your existing memories.

Email signup is also available: confirm your address, then return to finish connecting. No Mnemoverse API key is needed.

## Choose where you use Codex

| Your Codex | Start here | What you connect |
|---|---|---|
| Desktop app | [Install the published plugin](https://mnemoverse.com/docs/api/codex#desktop-app) | Mnemoverse Memory and its bundled skills |
| Terminal / CLI | [Add the memory server](https://mnemoverse.com/docs/api/codex#cli) | Memory tools, with browser sign-in |
| VS Code or another supported IDE | [Configure the Codex extension](https://mnemoverse.com/docs/api/codex#ide-extension) | Memory tools; IDE plugins are not supported |

Already connected? Check the plugin or server in the Codex environment you are using before adding another copy. Installing in ChatGPT does not by itself confirm that a separate CLI, editor or remote environment is connected.

## Desktop app {#desktop-app}

Codex and ChatGPT share the public plugin directory. In a Codex desktop environment with **Plugins**:

1. Open **Plugins**, search for **Mnemoverse Memory**, and open its card. You can also [open the public card](https://chatgpt.com/plugins/plugin_asdk_app_6ada598cec7c81918b22105edfafcb33).
2. Install the plugin if it is not already installed. When prompted, connect your Mnemoverse account in the browser and review the requested access.
3. Start a **new Codex chat**. Type **@** and select **Mnemoverse Memory**. In task views with **Sources**, use **Sources → Use plugins** to select it.
4. [Check the connection](https://mnemoverse.com/docs/api/codex#check-the-connection) below, then continue your task.

If the card opens in ChatGPT on the web, return to your Codex desktop environment and check its installed plugins. Available controls depend on the client and workspace. If that environment does not offer the plugin, use the [direct MCP alternative](https://mnemoverse.com/docs/api/codex#desktop-mcp) instead of assuming that the web installation carried over.

## Terminal / CLI {#cli}

Run this in your terminal on the computer where you use Codex:

```sh
codex mcp add mnemoverse --url https://mcp.mnemoverse.com/mcp
```

Complete the browser sign-in if it opens. Choose your intended Mnemoverse account and review the requested access. If the browser did not open or Codex says authentication is needed, run:

```sh
codex mcp login mnemoverse
```

If a Codex session is already open, enter this command inside it first:

```text
/exit
```

Start a fresh session from your terminal:

```sh
codex
```

Inside the session, enter:

```text
/mcp
```

Check that `mnemoverse` and its tools are available, then [check access](https://mnemoverse.com/docs/api/codex#check-the-connection).

This route adds the memory tools. For the separate package with skills, see [CLI plugin alternative](https://mnemoverse.com/docs/api/codex#cli-plugin).

## IDE extension {#ide-extension}

In the Codex extension:

1. Open the gear menu, then **MCP servers → Add server**.
2. Enter **mnemoverse** as the name, choose **Streamable HTTP**, and enter:

   ```text
   https://mcp.mnemoverse.com/mcp
   ```

3. Save, then select **Restart extension** when offered.
4. Select **Authenticate** if sign-in is required. Complete Mnemoverse sign-in in the browser, then return to the extension.
5. Open a new Codex conversation and [check access](https://mnemoverse.com/docs/api/codex#check-the-connection).

The CLI and IDE extension share MCP configuration on the same Codex host. If you already added `mnemoverse` with the CLI there, check the existing server instead of adding it twice. The IDE extension uses MCP tools directly; it does not install the plugin's bundled skills.

## Check the connection

Ask Codex:

```text
Use Mnemoverse to show my memory count without changing anything.
```

A successful Mnemoverse tool result confirms that this Codex environment can read your account; an ordinary chat answer alone does not. Zero is normal for a new account. If Codex reports a login or tool error, follow the relevant row below. A server name or list of tools alone does not confirm account access.

You can stop here if you only wanted to connect.

## Carry a project into your next task

When you have a real decision worth keeping, ask:

```text
Use Mnemoverse to draft a brief for this project:
its goal, the decisions we made, and the next step.
Show it to me before saving.
```

Review it and ask Codex to save it. Check the result of Mnemoverse’s save action, not just a reply saying “I’ll remember that.” A draft or an ordinary chat reply is not stored memory. In a new Codex task, ask:

```text
Use Mnemoverse to find the brief for [your project name]
and tell me where we left off.
```

Replace the brackets with your actual project name. You can ask the same question in [ChatGPT](https://mnemoverse.com/docs/api/chatgpt) after connecting it to the same Mnemoverse account.

## If it does not work

| What you see | What to do |
|---|---|
| Installed in ChatGPT, but missing in Codex | Check the environment and workspace you are using. Follow its desktop, CLI or IDE route above; installation is not proof of access in another environment. |
| Server listed, but sign-in required | CLI: run `codex mcp login mnemoverse`. Desktop or IDE: use **Authenticate** in the server settings. For a published plugin, finish the plugin's account connection. |
| Tools missing after setup | Start a new chat/session. In the CLI, inspect **/mcp**. In the IDE, check MCP settings and restart the extension when prompted. |
| You see different or no memories | Check which Mnemoverse account you connected. Different accounts have separate memories. |
| Reads work, but saving fails | Use the actual error to identify whether access, room membership or another restriction blocked the write. Keep the draft; do not remove the connection automatically. |
| A save times out | Ask Codex to check whether it saved before trying again, to avoid a duplicate. |

Send the visible error and the Codex client/version to [support@mnemoverse.com](mailto:support@mnemoverse.com). Do not send tokens, credentials or private configuration files.

## Other setup options

Choose one connection route for the environment. The following are alternatives, not additional required steps.

### Direct MCP in the desktop app {#desktop-mcp}

Open **Settings → MCP servers → Add server**. Name it **mnemoverse**, choose **Streamable HTTP**, and enter:

```text
https://mcp.mnemoverse.com/mcp
```

Save, select **Restart** when offered, then **Authenticate** to complete browser sign-in. Return to a new chat and [check access](https://mnemoverse.com/docs/api/codex#check-the-connection).

By default, direct MCP configuration lives in `~/.codex/config.toml` on the Codex host. Desktop, CLI and IDE can share it on that host; this is not automatic synchronization to other computers or cloud environments.

### CLI plugin alternative {#cli-plugin}

The CLI's plugin browser manages plugins for that Codex environment. Open it from a Codex session with:

```text
/plugins
```

A separate Mnemoverse package with skills is also available from our GitHub marketplace:

```sh
codex plugin marketplace add mnemoverse/claude-plugin
codex plugin add mnemoverse@mnemoverse
codex mcp login mnemoverse
```

Complete sign-in if required, then start a new session. This is the GitHub package, not the version published on the ChatGPT card. Codex loads its tools and skills, not its Claude-style commands. Do not add this alongside the direct server just to fix a sign-in error.

## Sources and verification

The routes follow OpenAI's [plugin selection help](https://help.openai.com/en/articles/20001256-plugins-in-chatgpt), [plugins guide](https://learn.chatgpt.com/docs/plugins), [Codex MCP setup](https://learn.chatgpt.com/docs/extend/mcp) and [CLI commands](https://learn.chatgpt.com/docs/developer-commands), checked 16 November 2026. CLI command spelling was also checked against local `codex --help` on version 0.169.0-alpha.11.1.

The direct MCP route previously passed sign-in and a memory-count call in Codex CLI 0.164.0 on Windows on 26 October 2026. Desktop/IDE and CLI plugin instructions are based on provider documentation, not a fresh Mnemoverse runtime test. Public plugin availability can vary by account and workspace.

## Related

- [ChatGPT: connect Mnemoverse Memory](https://mnemoverse.com/docs/api/chatgpt)
- [Make your agent use memory](https://mnemoverse.com/docs/api/agent-memory) — optional instructions for ongoing work
- [Tool availability](https://mnemoverse.com/docs/api/tool-availability)
- [Remote MCP reference](https://mnemoverse.com/docs/api/remote-mcp-server)
