Skip to main content

Prerequisites

Step 1: Configure CORE MCP Server

Create or open your Codex configuration file at ~/.codex/config.toml:

Step 2: Add CORE MCP Configuration

Option 1: URL-based Configuration (Recommended) Try this simpler configuration first. Add the following to your config.toml file:
Then run the login command:
This will authenticate your Codex CLI with CORE’s memory system. Option 2: API Key Configuration (If Option 1 doesn’t work) If the URL-based configuration doesn’t work, use this API key-based configuration:
To get your API key:
  1. Log into your CORE dashboard at app.getcore.me
  2. Navigate to Settings (bottom left) CORE Settings
  3. Go to API KeyGenerate new key → Name it “codex” Create API Key
  4. Copy the generated key and replace CORE_API_KEY in your config file
Then run:

Step 3: Verify Connection

Start Codex CLI and test your setup:
  1. Start Codex CLI - The CORE memory MCP server should now be available
  2. Test memory storage: Ask Codex to create a comprehensive summary of your codebase and add it to CORE memory for future reference
  3. Test memory retrieval: Ask Codex to search your memory for the stored summary
To make Codex automatically search and store memories for seamless project continuity: Create AGENTS.md in your project root (if it doesn’t exist, just append if it already exists):
Add the following to AGENTS.md:

How It Works

Once installed, CORE memory integrates seamlessly with Codex:
  • During conversation: Codex has access to your full memory graph and stored context
  • Memory operations: Use natural language to store and retrieve information across sessions
  • Across tools: Your memory is shared across Codex, Claude Code, Cursor, ChatGPT, and other CORE-connected tools
  • Project continuity: Context persists across all your AI coding sessions

Troubleshooting

Connection Issues:
  • Verify your API key is correct and hasn’t expired
  • Check that the config.toml file is properly formatted (valid TOML syntax)
  • Ensure the Bearer token format is correct: Bearer YOUR_API_KEY_HERE
  • Restart Codex CLI if the connection seems stuck
API Key Issues:
  • Make sure you copied the complete API key from CORE dashboard
  • Try regenerating your API key if authentication fails
  • Check that the key is active in your CORE account settings

Need Help?

Join our Discord community and ask questions in the #core-support channel. Our team and community members are ready to help you get the most out of CORE’s memory capabilities.