Skip to content

Connect Codex to Semrush

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

1,000 free credits · No card required

How to connect Semrush to Codex

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

    Connect Semrush to ApexGenius

    Connect Semrush

    Create an API key in Semrush. You paste it into ApexGenius once.

  2. 2ApexGenius

    Connect ApexGenius to Codex

    Choose Codex

    Back on Start, pick Codex and copy the prompt.

  3. 3ApexGenius

     

    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

Show a Semrush domain overview for my website in the US database. Run only that one report.

Start free
Written setup, step by stepShow

Before you start

  • A Semrush plan with API access. SEO data needs Semrush One Starter or Pro+, or SEO Classic Pro or Guru. SEO Classic Business and Semrush One Advanced need an API units package. Traffic and market data need a Trends API plan.
  • A Semrush API key from your Semrush profile under API Keys.

1. Connect Semrush to ApexGenius

  1. Copy an API key in Semrush. In Semrush, click your profile icon at the top right, then choose API Keys in the My profile sidebar. Copy an existing key, or choose + Create API key for a new v4 key. A new key is shown in full only once, so copy it right away.
    The full Semrush API keys page before sign-in, with a red box around Log in.
    The API keys page asks you to log in first. After you sign in, copy a key from My profile, API Keys.Open full-size image (opens in a new tab)
  2. Open Semrush in Connections. Sign in to ApexGenius, open Connections, choose Semrush, and select Connect.
  3. Enter the API key. Paste the key. ApexGenius supplies the mcp.semrush.com address, checks the key with Semrush's MCP, and stores it encrypted.
  4. Check the connection. Open Tools, then ask your AI the question below. Compare the answer with Semrush and check Tool Activity.
Connect Semrush →

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

Show a Semrush domain overview for my website in the US database. Run only that one report.

Show a Semrush domain overview for my website in the US database. Run only that one report.

Compare the numbers with Domain Overview in Semrush. Every report spends Semrush API units, including this one. Check your balance under My Profile > Subscription info > Summary.

Full guide: the Semrush 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
Show a Semrush domain overview for my website in the US database. Run only that one report.
ApexGenius
Working with ApexGenius1 tool search · 3 reads
RequestDomain overview
Account scopeAuthorized connections checked
apex_search_toolsSemrush domain reports · Find the Semrush report routeComplete
apex_call_read_tooldomain_overview · Find domain overview reportsComplete
apex_call_read_toolget_report_schema · Read the report parametersComplete
apex_call_read_toolexecute_report · Run the one reportComplete
Codex

Illustrative example: the overview returns the domain’s organic and paid search summary for the US database. One report ran and spent Semrush API units. Nothing was changed.

Read-only route
Codex

What to ask Codex about Semrush

  • Domain overview

    Show a Semrush domain overview for my website in the US database. Run only that one report.

    Runs domain_overview (read), then get_report_schema (read), then execute_report (read).

  • Organic competitors

    Which domains compete with my website in organic search? Keep it to the top ten.

    Runs competitors_research (read), then execute_report (read).

  • Keyword ideas

    Find related keywords for "project management software" with search volume. Limit it to 20 rows.

    Runs keyword_research (read), then get_report_schema (read), then execute_report (read).

These 3 questions use 5 of Semrush’s 14 operations. The full list is below.

  • List my Semrush projects and summarize the latest Position Tracking results for one of them. (read)

What Codex can do in Semrush

14 operations: 14 read. Every operation looks things up and changes nothing, so Codex cannot change Semrush through ApexGenius.

Domains and traffic

3 read
  • domain_overviewread
  • traffic_overviewread
  • competitors_researchread

Keywords and ads

4 read
  • organic_researchread
  • keyword_researchread
  • paid_search_researchread
  • shopping_researchread

Links and audience

2 read
  • backlinks_researchread
  • audience_researchread

Projects and tracking

3 read
  • projectsread
  • position_trackingread
  • site_auditread

Run a report

2 read
  • get_report_schemaread
  • execute_reportread

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

Semrush's MCP is read-only. It reads reports and project data. It cannot create projects, change settings or edit anything in Semrush, so there is nothing to undo.

Every report spends API units from your Semrush plan, the same as a direct API request. Semrush charges no extra fee for MCP. Ask for fewer rows to spend fewer units.

The key covers your Semrush account. One saved connection holds one key; connect again for a second account.

Disconnecting stops ApexGenius access. It does not restore units a report already spent. Manage or revoke the key itself in Semrush under API Keys.

Start free

Questions about connecting Codex to Semrush

Updated November 12, 2026.

How do I connect Codex to Semrush?

Sign in to ApexGenius and connect Semrush. 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 ask Codex: “Show a Semrush domain overview for my website in the US database. Run only that one report.” Start with a read, so nothing changes.

How do I check that Codex can use Semrush?

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: “Show a Semrush domain overview for my website in the US database. Run only that one report.”

Which Semrush plans work?

SEO data needs Semrush One Starter, Semrush One Pro+, SEO Classic Pro or SEO Classic Guru. Those plans include 50,000 API units that refresh on your renewal date. SEO Classic Business and Semrush One Advanced work with an API units package. Traffic and market data need a Trends API plan, Basic or Premium.

Does it use my Semrush API units?

Yes. Each report uses the same API units as a direct Semrush API request, and Semrush charges no extra MCP fee. Check your balance in Semrush under My Profile > Subscription info > Summary.

Where do I find my Semrush API key?

In Semrush, click your profile icon at the top right and choose API Keys in the My profile sidebar. Copy a key, or choose + Create API key for a new v4 key. A new key is shown in full only once.

Can my AI change anything in Semrush?

No. Semrush's MCP only reads. It can read your projects but cannot create projects, change settings or edit data, so there is nothing to undo.

Why an API key instead of signing in to Semrush?

ApexGenius connects with the API key method Semrush documents for AI agents. The key is sent only to mcp.semrush.com and stored encrypted. You manage the key itself in Semrush under API Keys.

Connect Semrush to Codex today

Start free

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