Connect Sides to Codex

Ask Codex about the music you own, then choose the changes it can make.

Before you connect

Use a current Codex release with Streamable HTTP and hosted OAuth/CIMD support, and the Sides account that owns your Archive. You can connect through the Codex app or CLI.

Check the version your terminal runs:

codex --version

If sign-in asks for manual client registration, check the current official MCP instructions and update the installation you are actually running. Do not copy a token or register a substitute client.

Add Sides and sign in

  1. Open a terminal and add a connection named sides-archive. If you already use that name for another server, choose an unused name and use it consistently in the commands below.
codex mcp add sides-archive --url https://app.sidesarchive.com/mcp
  1. Follow the browser sign-in opened by Codex. Sign in with the Sides account that owns your Archive, review the offered read and write permissions, and approve consent.
  2. Return to the terminal and check that Codex reports a successful login. Start a fresh Codex session to use the connection.

If adding the connection did not complete sign-in, start it with:

codex mcp login sides-archive

In the Codex app, Settings → MCP servers → Add server accepts the same URL with Streamable HTTP. Save and restart, then use Authenticate if required. The app and CLI use their documented connection settings; neither installs Sides task skills merely by connecting.

You don’t need a Sides-issued client ID, a client secret, a callback registration, or a copied token. Complete sign-in in the browser rather than pasting credentials into a conversation.

Ask your first question

In Codex, ask:

Use sides-archive to show me up to five Titles from my Archive, including the Copies I own. Don’t make any changes.

Check that the results are from your Archive. If it is empty, Codex should say so. Then try a particular artist, format, or Collection. Ask for more results when needed rather than reading the entire Archive at once.

The connection works without a skill. The four optional task skills provide intake, artwork, retrieval/management and export/recurring guidance. Confirm which procedure actually loads.

Choose when to allow changes

Sides requests its enabled read and write permissions together during hosted sign-in, including deletion, original artwork access and full Archive export. Review that consent before agreeing. Existing partial grants remain limited; connecting or installing a skill never silently expands them.

Your instructions and your assistant’s controls determine what to do with that access. With the optional intake skill loaded, researched metadata and artwork are proposed together before saving. You may approve metadata, artwork or both, or explicitly allow direct intake for either component and a stated scope. Exact corrections you supply can save directly. Deletion and replacing an existing cover retain their specific confirmation requirements.

If tools are missing, refresh discovery and start a fresh conversation. If the grant is incomplete, deliberately reconnect and review the current consent. Avoid repeated permission-upgrade attempts. A skill cannot grant access. More about permissions.

Disconnect or reconnect

To remove the selected local connection from Codex, close sessions using it, then run:

codex mcp logout sides-archive
codex mcp remove sides-archive

These commands remove local credentials and the server entry. Revoking permission at the sign-in provider is a separate action. For help ending that access, contact Sides support; never send access or refresh tokens. Removing a skill also leaves your connection’s permissions intact.

To reconnect after local removal, add the same Sides URL again and complete hosted sign-in. If only sign-in has expired or failed, use codex mcp login sides-archive and review consent. Information already shared remains with your AI provider under its policies.

If something goes wrong

Sign-in asks for a registration or fails before consent
Check your Codex version and the exact server address. Use the commands above without manual client IDs or bearer tokens. Keep existing connections intact.
You signed in to the wrong account
Stop the task and repeat hosted sign-in with the account that owns the intended Archive. Check the displayed identity before consenting.
A tool or permission is missing
Refresh discovery and check the current grant. For an old or partial grant, deliberately repeat hosted sign-in and review the enabled bundle. Do not loop incremental permission requests.
The service is busy or unavailable
Pause before retrying. Preserve the original request and retry key if a change’s outcome is uncertain. Don’t start duplicate edits or exports to check whether one completed.
A task stops while saving a file
Keep the same artwork or export version and follow the download guidance. A conversation’s displayed tool output is not a substitute for a complete checked file.

More help with searches, changes, and downloads · Official Codex MCP instructions

Sides is in beta.

Start building your Archive now. Sign up before January 1, 2027 (Pacific time), and your 14-day trial clock won’t start until January 1.

You can use Sides through January 14, 2027 (Pacific time), with up to 50 Titles and 5 Maestro assists for the whole trial.

Use the extra time to explore Sides with your own recordings and let us know what could work better.

Start free trial