Agent setup
Connect Codex to gtm.help
Codex talks to gtm.help over MCP, so the same tools you get in Claude or Cursor work from the terminal: analyse a site, pull the ranked plays for a workspace, mark work shipped and drop notes back into the plan.
- Takes ~1 minute
- OAuth sign-in
- Free site analysis
Add your website — see your ranked plan in about a minute, free.
Setup
Add the MCP server in Codex.
Step 1
Open your Codex config
Codex reads MCP servers from ~/.codex/config.toml. Create the file if it isn't there yet.
Step 2
Add the gtm.help server
Codex launches MCP servers as local processes, so wrap the hosted endpoint with mcp-remote. It handles the OAuth sign-in for you.
[mcp_servers.gtm-help] command = "npx" args = ["-y", "mcp-remote", "https://gtm.help/mcp"]Step 3
Sign in once
Start Codex and run the tool below. A browser window opens for the gtm.help sign-in; the token is cached, so you only do this once per machine.
codexStep 4
Put it to work
Ask Codex for the plan the same way you'd ask in chat.
Use gtm.help to analyse example.com, then list this week's plays with hours and cost.
Try it
First things to ask.
Once Codex is connected, these prompts confirm everything works.
- “Analyse stripe.com and give me three growth plays.” (free, no plan needed)
- “List my gtm.help workspaces.”
- “What should I ship this week?”
- “Mark the cold outbound play complete and share a recap.”
Good to know
Notes and troubleshooting.
- Any MCP client works the same way — the endpoint is https://gtm.help/mcp and there is no separate REST API or API key to manage.
- analyze_site is free for any connected account; plan, workspace and completion tools need an active Growth or Agency plan.
- If Codex lists the server with no tools, delete the cached mcp-remote credentials in ~/.mcp-auth and sign in again.
Get started
Run your growth plan from Codex.
Start a 7-day trial and your agent can read the plan, ship plays and post recaps.
Add your website and see your own ranked plan.
