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
- 1Sign in to ApexGenius and connect Semrush
- 2Add the ApexGenius plugin to Codex
- 3Start using Semrush in Codex
- 1
Connect Semrush to ApexGenius
Connect Semrush
Create an API key in Semrush. You paste it into ApexGenius once.
- 2
Connect ApexGenius to Codex
Choose Codex
Back on Start, pick Codex and copy the prompt.
- 3
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.
- 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.
- No plugin? Open Settings, then MCP servers, then Add server. Name it ApexGenius, choose Streamable HTTP and paste the MCP address.
- Save, select Restart, then Authenticate, and sign in to ApexGenius in your browser.
- 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.
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
- 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 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) - Open Semrush in Connections. Sign in to ApexGenius, open Connections, choose Semrush, and select Connect.
- 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.
- Check the connection. Open Tools, then ask your AI the question below. Compare the answer with Semrush and check Tool Activity.
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 listshows the configured servers, andcodex mcp login apexgeniusruns 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.




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/mcpNo plugin available? Use desktop settings
- In the ChatGPT desktop app, open Settings, then MCP servers, then Add server.
- Name the server ApexGenius, choose Streamable HTTP, and paste the MCP address below.
- Save, select Restart, then Authenticate. Sign in to ApexGenius and authorize the intended connections and access.
- 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/mcpManual 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/mcpAuthorize in your browser
codex mcp login apexgeniusInspect registered servers
codex mcp listThe 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.
apex_search_toolsSemrush domain reports · Find the Semrush report routeCompleteapex_call_read_tooldomain_overview · Find domain overview reportsCompleteapex_call_read_toolget_report_schema · Read the report parametersCompleteapex_call_read_toolexecute_report · Run the one reportCompleteIllustrative 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 routeWhat 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), thenget_report_schema(read), thenexecute_report(read). - Organic competitors
Which domains compete with my website in organic search? Keep it to the top ten.
Runs
competitors_research(read), thenexecute_report(read). - Keyword ideas
Find related keywords for "project management software" with search volume. Limit it to 20 rows.
Runs
keyword_research(read), thenget_report_schema(read), thenexecute_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 readdomain_overviewreadList the domain overview reports you can run for a domain.
traffic_overviewreadList the website traffic reports you can run.
competitors_researchreadList the competitor reports you can run for a domain.
Keywords and ads
4 readorganic_researchreadList the organic search reports you can run for a domain.
keyword_researchreadList the keyword research reports you can run.
paid_search_researchreadList the paid search reports you can run.
shopping_researchreadList the shopping research reports you can run.
Links and audience
2 readbacklinks_researchreadList the backlink reports you can run.
audience_researchreadList the audience reports you can run.
Projects and tracking
3 readprojectsreadList the reports you can run on your Semrush projects.
position_trackingreadList the Position Tracking reports you can run.
site_auditreadList the Site Audit reports you can run.
Run a report
2 readget_report_schemareadRead the parameters one report takes before you run it.
execute_reportreadRun one report and return its data. Spends Semrush API units.
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.
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.
More connections like this one
Codex with other apps
ChatGPT Ads
Google Ads
Google Analytics
Blotato
Bing Webmaster
YouTube
YouTube Analytics
Google Search Console
All 48 apps Codex can use
TypeSafeSupabase
Mobbin
Cal.com
SlackDiscord
GitHub
Stripe
Context.dev
Attio
Notion
Apify
Linear
Jira
HQ Rental
Google Forms
Google Meet
Google Tasks
Gmail
Google Calendar
Google Chat
Google Docs
Google Drive
Google Sheets
Google Slides
Apollo
Calendly
ClickUp
monday.com
Atlassian Rovo
Polymarket
OP.GGSalesforce
n8n
Confluence
ElevenLabs
FreshBooks
Trello
GitLab
HubSpot
Connect Semrush to Codex today
Start free1,000 free credits. No card required. Disconnect any time.