Codex connector
Connect Mosaico to Codex
How to add the Mosaico connector to Codex and what it can do.
What you get
The Mosaico connector lets you work with your organisation from Codex. You ask in plain words, and Codex reads your flows, people, teams, domains and capabilities from Mosaico. When you ask for a change, Codex shows you a preview first. Nothing is saved until you approve it. You sign in with your own Mosaico account, and Codex can only do what your role in Mosaico already allows.
Before you start
- A Mosaico account in an organisation. Owners and Admins can invite you from Mosaico.
- Codex installed (the command line tool), or the ChatGPT desktop app or the Codex IDE extension. All three share the same connector settings.
- A Codex plan that allows it.
Add the connector (command line)
About 5 minutes. Do these in order.
- Add Mosaico. In a terminal, run:
codex mcp add mosaico --url https://app.mosaico.one/api/mcpLeave out any client ID or secret: Mosaico does not use them. - Sign in. Run:
codex mcp login mosaicoYour browser opens. Sign in with your own Mosaico account and choose Allow on the consent screen. If there is no browser on that machine, runcodex mcp login mosaico --no-browser, open the address it prints, sign in, and paste the full address you land on back into the terminal. - Check it. Run
codex mcp list. In Codex, type/mcpto see active servers.
Start Codex and ask about your organisation, for example: Show me my daily brief.
If the sign-in fails, Codex chooses how to register itself automatically. You can force a method for one sign-in with --oauth-client-registration cimd or --oauth-client-registration dcr; Mosaico accepts both.
Add the connector (settings file)
Instead of the commands, add this to ~/.codex/config.toml, or .codex/config.toml in a trusted project, then run codex mcp login mosaico:
[mcp_servers.mosaico]
url = "https://app.mosaico.one/api/mcp"Add the connector (ChatGPT desktop app or IDE extension)
- Desktop app: Settings, then MCP servers, then Add server. Choose Streamable HTTP, enter https://app.mosaico.one/api/mcp, save, select Restart, then Authenticate.
- IDE extension: the gear menu, then MCP servers, then Add server. Enter the same address, save, then Restart extension.
What Codex can do
Codex acts only inside your own organisation, with the access your role already has.
- Daily brief: what changed, what is due, and what needs you.
- Teams and people: see who is on which team and what each person is working on.
- Flows and tasks: list your flows, read one in full, and see the tasks in it. Your reseller installs your flows; Owners and Admins can set due dates and assign people and teams.
- Domains and capabilities: see the capabilities your positions need and where the gaps are.
- Previews before changes: every change is shown to you first and is saved only when you approve it.
Mosaico receives only what Codex sends with each request. It does not read your Codex conversation history or files.
Disconnect
An Owner or Admin can disconnect Codex in Mosaico, under Integrations, then Connected apps. Choose Revoke next to the connection. Codex loses access straight away. To stop using it on your own computer, remove the [mcp_servers.mosaico] block from your config.toml.
Help
Email help@mosaico.one and we will help you get connected. To see how we handle your data and the terms of use, read the Privacy Policy and the Terms of Service linked below.