Codex · CLI and desktop
Connect your Codex workspace
Set your local credentials
Replace the key placeholder. Start Codex from this same terminal so it can read the variables.
export SYNTARUS_API_KEY="sk_mem_your_key_here"
export SYNTARUS_USER_ID="developer_workspace"Add the MCP server
Merge this into your personal ~/.codex/config.toml. Keep any existing server entries.
[mcp_servers.syntarus]
command = "uvx"
args = ["syntarus-mcp"]
env_vars = ["SYNTARUS_API_KEY", "SYNTARUS_USER_ID"]Using the Codex desktop app?
A launcher-opened app may not inherit terminal variables. Instead, use this entry in your personal config, then fully restart Codex. It contains your key; keep it out of Git.
[mcp_servers.syntarus]
command = "uvx"
args = ["syntarus-mcp"]
env = { SYNTARUS_API_KEY = "sk_mem_your_key_here", SYNTARUS_USER_ID = "developer_workspace" }Use one entry, not both. On Windows, ~ is your user home folder.
Restart and check the connection
In the CLI, run codex mcp list and use /mcp in a session. In the desktop app, check Syntarus in MCP settings. Then try the memory test beside this guide.