Skip to main content
Use ChatSyncs from OpenAI Codex: in the ChatGPT desktop app, your code editor, or the terminal.

​
Before you start

  • Codex installed and signed in, as the ChatGPT desktop app, the Codex IDE extension, or the Codex CLI. Codex works with a ChatGPT plan that includes Codex, or an OpenAI API key.
  • Terminal route only: to open a terminal, use the Terminal app on a Mac (Applications → Utilities) or PowerShell on Windows (Start menu). ~ means your home folder.
  • Your ChatSyncs API key, from the API Developer Console. How to find it.
The Codex CLI, the Codex IDE extension and the ChatGPT desktop app share one settings file (~/.codex/config.toml). Set ChatSyncs up once and it’s available in all three.

​
Connect

Pick the way you use Codex. All three end in the same place, because they share one settings file.
1

Open MCP settings

Open Settings, then select MCP servers, and click Add server.
2

Enter ChatSyncs

Name: chatsyncs. Type: Streamable HTTP. URL:
Save it, then select Restart.
3

Sign in

Next to chatsyncs, select Authenticate. The ChatSyncs connect page opens in your browser, naming the app asking to connect. Paste your API key and click the blue Authorize button.

​
Check it worked

Start Codex and ask:
“List my WhatsApp templates.”
Codex asks for approval to call the ChatSyncs tool, then lists your templates.

​
Disconnect

To cut off every app that has your key, regenerate it.

​
Frequently asked

Yes, but it’s for technical users. Codex reads the key from an environment variable (a named value your computer passes to programs), so the key isn’t written into the settings file:
You then have to make CHATSYNCS_API_KEY hold your key wherever Codex starts. Apps opened from the Dock or Start menu often don’t see variables set in a terminal, so browser sign-in is the better choice for most people.
Run codex mcp login chatsyncs --no-browser. Codex prints a link: open it on any device, paste your key and click Authorize. Your browser then lands on a localhost address that may show an error page. That’s expected: copy that whole address from the address bar and paste it back into the terminal when Codex asks.
No. The ChatGPT desktop app, the IDE extension and the CLI read the same ~/.codex/config.toml, so once it’s added and signed in, it’s in all three.

​
Gotchas

  • Forgot --url. Without it, Codex treats the address as a program to run and fails. Remove it and add it again with --url.
  • Listed but every action fails. You haven’t signed in yet. Select Authenticate in the app, or run codex mcp login chatsyncs.
  • Hand-edited the file and Codex won’t start. A missing quote or bracket breaks the whole file. Compare your entry with the example above, character for character.