# Add Mosyn to OpenAI Codex

MCP URL: https://mosyn.lycatra.com/mcp

## 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:

```sh
codex plugin marketplace add ponderingBGI/mosyn-plugin
```

Install the plugin:

```sh
codex plugin add mosyn@mosyn
```

Or add only the connector:

```sh
codex mcp add mosyn --url https://mosyn.lycatra.com/mcp
```

Sign in (if needed):

```sh
codex mcp login mosyn
```

Check it:

```sh
codex mcp list
```

## Config file

`~/.codex/config.toml`:

```toml
[mcp_servers.mosyn]
url = "https://mosyn.lycatra.com/mcp"
```

## Sign in

Codex opens Mosyn's approval page in the browser and listens on a local port for the result.

## Approve on your phone

A browser page from Mosyn opens with an eight-character code and a QR code. Open the Mosyn app on your phone and approve the request there (scan the QR code, tap the link on the phone, or type the code in Settings → Connect an assistant → Have a code?).

Never paste the code into a chat; it goes into the Mosyn app only.

## Check that it worked

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

## If something goes wrong

| What you see | What 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. |

## Sources

- https://developers.openai.com/codex/mcp
- https://github.com/openai/codex/blob/main/codex-rs/cli/src/mcp_cmd.rs
- https://github.com/ponderingBGI/mosyn-plugin

Last checked 2026-09-26. All assistants: https://mosyn.lycatra.com/connect.md
