Skip to content
Connect your AI

Codex

Connect Codex to the project context that lives beyond a single coding task. Read specifications and previous decisions, save debugging findings, and hand completed work to another agent through the same MindWiki vault.

Let Codex prepare setup

Paste this into Codex with its configuration-editing tools enabled. It can prepare the connection; you complete browser sign-in and any host approval.

Paste into your agent

Codex CLI setup

Run these commands in your terminal:

bash
codex mcp add mindwiki --url https://api.mindwiki.io/mcp
codex mcp login mindwiki

Finish sign-in in your browser, then start or reopen a Codex session. Use /mcp to inspect enabled servers. The local CLI stores the server in its own configuration; you do not need a JSON configuration copied from another client.

In the Codex desktop app or IDE extension, use the MCP configuration controls for that surface. A hosted Codex environment needs its own supported connection setup; configuring your local CLI does not configure a cloud task.

Complete the MindWiki connection

On MindWiki's authorization page, MindWiki Email + Access Key is the recommended sign-in method. Existing email-and-password accounts can choose Legacy Sign In; Sign in with Apple remains available. All methods open the same account and vault—no replacement account is required. New users choose Create a new vault, save their generated access key and continue. Review the requested permissions and choose read-only access when that is all you need. Access Keys explains the supported methods.

Return to your agent after approving. Your sign-in key belongs on MindWiki's pages, not in chat or an MCP configuration file. The client handles its own OAuth credentials.

Check that it works

Ask your agent:

text
Use MindWiki to read my account status, then search for a note about one of my projects. Read a matching page and cite its title and path. Tell me if the vault is empty rather than making up a result.

Inspect the tool result and compare it with a page in MindWiki Cloud. For a new vault, the agent can read the operating guide and initialize the starter pages when account status permits it.

To check saving after granting write or capture access, ask “Save a new MindWiki capture titled Connection check with today's date, then read it back and give me its path.” The same file is available in your MindWiki apps.

Work with the vault in Codex desktop

With MindWiki connected, ask Codex to open the interactive MindWiki vault to search and preview notes. For a project Markdown file, open its file tab and use Open → Open in ChatGPT → MindWiki Markdown Viewer and Editor. In the editor, Save changes is available when the host grants write access to that file. In a text-only client, ask Codex to use MindWiki search, read, or capture tools directly.

Useful Codex workflows

  • Implement with context: “Read our API design notes in MindWiki before you change the endpoint. Flag contradictions with the repository.”
  • Keep debugging knowledge: “Save the cause, reproduction steps and fix for this CI failure, including what the tests verified.”
  • Handoff between agents: “Read the handoff from Claude, continue the coding work, then update the handoff with results.”

Ask Codex to save a concise decision or outcome, rather than copying credentials or full terminal logs into the vault.

Troubleshooting

Check codex mcp list and restart the session if newly configured tools are not visible. Run codex mcp login mindwiki again after revocation. If an older CLI reports that OAuth requires experimental_use_rmcp_client, follow that installed version's help or update Codex. A network-restricted execution environment may need to allow the public MCP endpoint before it can connect.

Permissions and disconnecting

Available tools depend on the scopes you approved, your MindWiki plan and vault permissions, and the tools your client exposes. Free includes one external AI connection with core vault tools. See MCP tool access.

To disconnect just this client, revoke its grant in MindWiki Connections. Other agents keep their own connections. Never send access keys or OAuth tokens to support.

More help

MCP tools · Agent permissions · All AI agents

Setup reference: Codex MCP documentation, checked October 20, 2026.