Skip to content
Mosyn

Add Mosyn to OpenAI Codex

Steps

  1. Install the Mosyn plugin. It adds Mosyn and a skill that teaches Codex how to build a good study set.
  2. Or add only the connector. Codex notices that Mosyn uses sign-in and starts it right away.
  3. If the sign-in didn't start, run the login command.

Commands

Add the Mosyn plugin catalog
codex plugin marketplace add ponderingBGI/mosyn-plugin
Install the plugin
codex plugin add mosyn@mosyn
Or add only the connector
codex mcp add mosyn --url https://mosyn.lycatra.com/mcp
Sign in (if needed)
codex mcp login mosyn
Check it
codex mcp list
Or add it to the config file
~/.codex/config.toml
[mcp_servers.mosyn]
url = "https://mosyn.lycatra.com/mcp"

Sign in and approve

  1. On your computerSign inCodex opens Mosyn's approval page in the browser and listens on a local port for the result.
  2. On your phoneApprove on your phoneMosyn's approval page shows a QR code. Scan it with your phone, or in Mosyn open Settings → Connect an assistant → Have a code? and type the code shown.

Check that it worked

`codex mcp list` (or `/mcp` in the TUI) shows mosyn with its tools.

If something goes wrong

What you seeWhat to do
“The mosyn MCP server is not logged in. Run `codex mcp login mosyn`”Run `codex mcp login mosyn`.
Sign-in on a remote or headless machine never completes.Set `mcp_oauth_callback_port` (and, if needed, `mcp_oauth_callback_url`) at the top of config.toml, or sign in on a machine with a browser.
An older guide says to set `experimental_use_rmcp_client = true`.Not needed any more. Update Codex instead.

[email protected]

Add Mosyn to OpenAI Codex | Mosyn