Skip to content

Connect Codex to GitHub

Connect Codex to GitHub in 3 steps: 1. Sign in to ApexGenius and connect GitHub. 2. Add the ApexGenius plugin. 3. Start using GitHub in Codex. Start in Plugins in the ChatGPT desktop app and authorize your connection.

1,000 free credits · No card required

How to connect GitHub to Codex

  1. 1Sign in to ApexGenius and connect GitHub
  2. 2Add the ApexGenius plugin to Codex
  3. 3Start using GitHub in Codex
  1. 1GitHub

    Connect GitHub to ApexGenius

    Connect GitHub

    GitHub opens its own sign-in. Sign in and allow ApexGenius.

  2. 2ApexGenius

     

    Choose your repositories

    Pick the repositories your AI may use. Add more later from the connection page.

  3. 3ApexGenius

    Connect ApexGenius to Codex

    Choose Codex

    Back on Start, pick Codex and copy the prompt.

  4. 4ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius plugin to Codex

Codex stores MCP servers in ~/.codex/config.toml. The ChatGPT desktop app, the Codex CLI and the IDE extension share that file, so one setup covers all three on the same machine.

  1. In the ChatGPT desktop app, open Plugins and select an ApexGenius plugin shared with you or one you created. Connect it and authorize the app connections you intend to use.
  2. No plugin? Open Settings, then MCP servers, then Add server. Name it ApexGenius, choose Streamable HTTP and paste the MCP address.
  3. Save, select Restart, then Authenticate, and sign in to ApexGenius in your browser.
  4. Start a new Codex task.

The MCP address

https://server.autom8.pro/mcp

Check it. In the composer, type /mcp to view the connected servers.

Steps follow OpenAI documentation, Model Context Protocol for ChatGPT and Codex (opens in a new tab), read November 12, 2026.

Then ask Codex

Using GitHub, tell me which GitHub account is connected, then read the README of the repository I name. Do not change anything.

Start free
Written setup, step by stepShow

Before you start

  • A GitHub account that can read the repositories you want your AI to use.
  • For a repository owned by an organization, an owner who can approve the ApexGenius Connect app.

1. Connect GitHub to ApexGenius

  1. Open GitHub in Connections. Sign in to ApexGenius, open Connections, choose GitHub, and select Connect.
    The ApexGenius Connections page with GitHub in the Available group and its Connect button.
    Open Connections and find GitHub. Until you connect it, its row shows Connect.Open full-size image (opens in a new tab)
  2. Sign in to GitHub. GitHub asks which account to use. Choose Continue on the one you want and approve the ApexGenius Connect app. Nothing is pasted, and the sign-in renews itself.
    GitHub's Select user to authorize ApexGenius Connect page, with the account names blurred and a red box around the Continue row.
    GitHub asks which account to use. Choose Continue on the one you want. Account names are blurred in this capture.Open full-size image (opens in a new tab)
  3. Choose your repositories. Pick your account or an organization, choose Only select repositories, pick the ones your AI may use, and select Install. GitHub brings you back to ApexGenius. Add more later with Choose repos on GitHub on the connection page. An organization owner may need to approve the app.
    The GitHub page in ApexGenius with the status control menu open, showing Check again and Choose repos on GitHub.
    Back in ApexGenius, open the status control and choose Choose repos on GitHub to install the app on your repositories.Open full-size image (opens in a new tab)
    GitHub's Install ApexGenius Connect page asking where to install, listing a personal account (blurred) and an organization, with a red box around both.
    Pick your account or an organization to install the ApexGenius Connect app on.Open full-size image (opens in a new tab)
    GitHub's Install ApexGenius Connect form with All repositories and Only select repositories, the permissions, and red boxes around Only select repositories and Install.
    Choose Only select repositories, pick the ones your AI may use, then Install. ApexGenius keeps the connection read-only until you turn on writes.Open full-size image (opens in a new tab)
  4. Check the connected account. Your repositories appear on the connection Overview. Ask your AI the question below and compare the login with your GitHub account.
    The GitHub connection Overview in ApexGenius showing a green Connected status, rows for Tools, Agents and Skill, recent calls, and one repository switched on with its name blurred.
    After you connect, Overview shows Connected and lists your repositories. The repository name is blurred in this capture.Open full-size image (opens in a new tab)
Connect GitHub →

2. Connect ApexGenius to Codex

The steps are above, under Add the ApexGenius plugin to Codex. These notes apply to Codex only.

  • From the terminal. The commands are under Manual setup for developers. codex mcp list shows the configured servers, and codex mcp login apexgenius runs the sign-in.
  • Without a local browser. Run codex mcp login apexgenius --no-browser, open the printed authorization URL on another machine, sign in, and paste the full redirect URL back into the terminal.
  • Asking before writes. In config.toml, default_tools_approval_mode = "writes" on the apexgenius server makes Codex ask before any tool that is not marked read-only.
  • ChatGPT on the web. ChatGPT on the web does not read local Codex configuration. It uses plugins.
  • Access. When ApexGenius asks what Codex may use, choose Read only for the first test, or Custom to limit it to the tools you need.

Watch the setup

Follow each step at your own pace.

Codex desktop app with Plugins selected and ApexGenius listed under Available to your account.
Open Codex in the ChatGPT desktop app, then Plugins, and find ApexGenius.Open full-size image (opens in a new tab)

The walkthrough uses the original ChatGPT web plugin captures. After connecting, open Codex in the desktop app and start a new task with ApexGenius. A ChatGPT web connection does not verify Codex access.

A public ApexGenius plugin listing is not verified. Use a plugin shared with you or one you created, subject to your account and workspace policy.

Create a personal plugin

Where Developer mode is available, open ChatGPT Settings, then Security and login, and enable it. In Plugins, select the plus button, enter ApexGenius and a description, then add this URL under Connection. Create the connection, complete OAuth, and review the tools. Return to Codex in the desktop app and start a new task with the plugin enabled.

https://server.autom8.pro/mcp
OpenAI custom connection guide (opens in a new tab)
No plugin available? Use desktop settings
  1. In the ChatGPT desktop app, open Settings, then MCP servers, then Add server.
  2. Name the server ApexGenius, choose Streamable HTTP, and paste the MCP address below.
  3. Save, select Restart, then Authenticate. Sign in to ApexGenius and authorize the intended connections and access.
  4. Start a new Codex task and ask one read-only question. Check the returned result and its matching successful read in Activity.
https://server.autom8.pro/mcp
OpenAI desktop MCP settings (opens in a new tab)
Manual setup for developers

Codex CLI is optional. Run these commands, complete browser authorization, then start a new session. Do not paste bearer tokens or static authorization headers.

Register the remote MCP server

codex mcp add apexgenius --url https://server.autom8.pro/mcp

Authorize in your browser

codex mcp login apexgenius

Inspect registered servers

codex mcp list

The desktop app, CLI, and IDE extension share MCP configuration on the same host. The IDE extension does not install plugins. ChatGPT web does not read local Codex configuration.

3. Verify one safe read

Using GitHub, tell me which GitHub account is connected, then read the README of the repository I name. Do not change anything.

Using GitHub, tell me which GitHub account is connected, then read the README of the repository I name. Do not change anything.

Confirm the login matches your GitHub account and the README matches the repository on github.com. If the README is missing, install the app on that repository with Choose repos on GitHub. New connections are read-only, so this check changes nothing. To let your AI open issues or open, review and merge pull requests, open the Tools tab on the connection, choose Settings, and switch to Read and write.

Full guide: the GitHub setup guide.

What it looks like in Codex

Illustration of a task, not a recorded customer result. Your answers come from the account and dates you choose.

How the route works
Codex
CodexApexGenius MCP route
Which GitHub account is connected? Do not change anything.
ApexGenius
Working with ApexGenius1 tool search · 1 read
RequestCheck the account
Account scopeAuthorized connections checked
apex_search_toolsGitHub account · Find GitHub readsComplete
apex_call_read_toolget_me · Read the connected accountComplete
Codex

Illustrative example: the connection belongs to the login octo-dev. Compare it with the GitHub account you meant to connect before reading a repository.

Read-only route
Codex

What to ask Codex about GitHub

  • Check the account

    Which GitHub account is connected? Do not change anything.

    Runs get_me (read).

  • Open pull requests

    Summarize the open pull requests in the repository I name, with author, age and review status.

    Runs list_pull_requests (read), then pull_request_read (read).

  • Read a file

    Read the config file I name on the main branch and explain what it sets.

    Runs get_file_contents (read).

These 3 questions use 4 of GitHub’s 44 operations. The full list is below.

  • List the bug issues opened in the last 30 days in the repository I name. (read)
  • What changed in the latest release of the repository I name? (read)
  • In the repository I name, open an issue titled "Flaky checkout test" with the failure I paste, then read it back to me. (write)

What Codex can do in GitHub

44 operations: 29 read, 15 write. Read looks things up and changes nothing. Writes change GitHub and run only when you turn them on.

Account and teams

3 read
  • get_meread
  • get_teamsread
  • get_team_membersread

Repositories and code

4 read
  • search_repositoriesread
  • get_file_contentsread
  • search_coderead
  • list_repository_collaboratorsread

Commits, branches and tags

6 read
  • list_commitsread
  • get_commitread
  • search_commitsread
  • list_branchesread
  • list_tagsread
  • get_tagread

Releases

3 read
  • list_releasesread
  • get_latest_releaseread
  • get_release_by_tagread

Issues

6 read · 4 write
  • list_issuesread
  • issue_readread
  • search_issuesread
  • get_labelread
  • list_issue_typesread
  • list_issue_fieldsread
  • issue_writewrite
  • add_issue_commentwrite
  • update_issue_commentwrite
  • sub_issue_writewrite

Pull requests

3 read · 7 write
  • list_pull_requestsread
  • pull_request_readread
  • search_pull_requestsread
  • create_pull_requestwrite
  • merge_pull_requestwrite
  • update_pull_requestwrite
  • update_pull_request_branchwrite
  • pull_request_review_writewrite
  • add_comment_to_pending_reviewwrite
  • add_reply_to_pull_request_commentwrite

People

1 read
  • search_usersread

GitHub Actions

3 read
  • actions_listread
  • actions_getread
  • get_job_logsread

Branch and file writes

3 write
  • create_branchwrite
  • create_or_update_filewrite
  • push_fileswrite

Workflow runs

1 write
  • actions_run_triggerwrite

You choose the access. When you approve Codex, pick Full access, Read only, or Custom.

GitHub checks the connection on every call. Your AI sees only the repositories the app is installed on.

Connections start read-only: ApexGenius sends GitHub’s read-only header, so write tools are not listed and cannot run. Under Settings you can switch one connection to read and write for the repositories you name; reads and writes then stay inside that list.

Manual workflow runs are off until you switch them on for a repository. A PR merge can still trigger workflows and deployments. Deleting files or run logs, and creating, deleting or forking repositories stay blocked. Every write is audited and runs when called.

An organization owner may need to approve the ApexGenius Connect app before it reaches the organization’s repositories.

Disconnecting removes the connection from ApexGenius. To stop access everywhere, uninstall the ApexGenius Connect app on GitHub.

Start free

Questions about connecting Codex to GitHub

Updated November 12, 2026.

How do I connect Codex to GitHub?

Connect Codex to GitHub through ApexGenius in three steps. Sign in to ApexGenius and connect GitHub with your GitHub login, choosing the repositories. In the ChatGPT desktop app, open Plugins and connect an ApexGenius plugin, or open Settings, then MCP servers, then Add server, and add the ApexGenius MCP address as a Streamable HTTP server. Then start a task in Codex and ask a GitHub question.

How do I check that Codex can use GitHub?

In the Codex composer, type /mcp to view the connected servers. ApexGenius should be listed. If it asks for sign-in, open Settings, then MCP servers, and select Authenticate. Start a new task, then ask: “Using GitHub, tell me which GitHub account is connected, then read the README of the repository I name. Do not change anything.”

Is there a GitHub MCP server for Codex?

Yes. ApexGenius is an MCP server that Codex connects to once. It carries your GitHub connection and 44 GitHub operations, so Codex does not need a separate GitHub integration or plugin.

What can Codex do in GitHub once it is connected?

Codex can run 44 GitHub operations through ApexGenius: 29 reads across repositories, code, commits, branches, releases, issues, pull requests and teams, and 15 writes that open issues, comment, push branches, and open, review or merge pull requests once you turn writes on.

Can Codex read my private GitHub repositories?

Yes. Codex reads the private GitHub repositories you install the ApexGenius Connect app on, and nothing else. GitHub checks the installation on every call, and you add or remove repositories on GitHub at any time.

Can Codex change my GitHub repositories?

Not until you turn writes on. A GitHub connection in ApexGenius starts read only. Under Settings you name the repositories and switch to read and write, and Codex can then open issues, comment, push branches, and open, review or merge pull requests there. GitHub permissions and branch rules still apply. Deleting files, and creating, deleting or forking repositories are always refused.

Can I use the same GitHub connection with Claude, ChatGPT, Grok Bot or Muse?

Yes. One GitHub connection in ApexGenius works with every compatible agent you add, including Claude, ChatGPT, Grok Bot or Muse. Each agent gets its own access choice and its own short setup, and the GitHub skill loads in all of them.

Connect GitHub to Codex today

Start free

1,000 free credits. No card required. Disconnect any time.