AI SEO Malaysia
Back to Docs

Install the AI SEO plugin for Codex

Add AI SEO MCP and Agent Skills to Codex with one marketplace and one install command.

The AI SEO plugin bundles AI SEO MCP and all twelve SEO Agent Skills into one install. This is the preferred way to set up AI SEO in Codex CLI.

Desktop app

In the ChatGPT desktop app, open Codex and start a new chat. Paste the agent setup prompt so Codex can configure AI SEO and guide you through sign-in.

If AI SEO appears in your Plugins directory, install it, approve the AI SEO sign-in, and start a new Codex chat. If the listing is missing, use the setup prompt or the CLI steps below.

Ask: “Use AI SEO to check my connection and list my projects.” The check uses no AI SEO credits. A tool call followed by your projects, or an empty list, confirms that this chat is connected.

Check OpenAI's plan support for access to your Codex client. Installing in Codex does not connect a regular chat on chatgpt.com. For that, use the ChatGPT guide.

Install in the CLI

Run these commands in your terminal:

codex plugin marketplace add insightseomy/aiseo-plugin
codex plugin add aiseo@aiseo
codex mcp login aiseo

codex mcp login opens a browser to approve the AI SEO connection. If it reports that aiseo isn't found, restart Codex first — bundled MCP servers only register after a restart, not immediately after install — then run codex mcp login aiseo again.

Codex connects AI SEO MCP at https://app.checker.aiseo.com.my/mcp and enables twelve skills:

  • SEO Project Setup
  • SEO Coach
  • SEO Audit
  • AI Visibility Audit
  • AI Prompt Research
  • Keyword Research
  • Keyword Clustering
  • Competitive Landscape
  • Competitor Analysis
  • Local SEO
  • Link Prospecting
  • SEO Report

Run a skill

Type $ in Codex to see available skills, or ask Codex to run one by name, for example "run seo-project-setup" or "run seo-audit on example.com".

Update

codex plugin marketplace upgrade aiseo

Reload or restart Codex if the updated skills are not available. For other installation methods, see Agent setup and skill updates.

Remove

codex plugin remove aiseo@aiseo

Troubleshooting

If the AI SEO MCP server doesn't appear after restart, run /mcp in the Codex TUI to check its status, then run codex mcp login aiseo again.

If it still doesn't authenticate, log out first and retry:

codex mcp logout aiseo
codex mcp login aiseo

If a codex plugin command reports "unrecognized subcommand," run codex plugin --help to see the subcommands your installed version actually supports — they've changed across versions (for example, add/remove, not install/uninstall).

Other clients

For ChatGPT web, use the ChatGPT setup guide. For Claude Code or Claude Cowork, use the AI SEO plugin for Claude instead. For Cursor or an API key setup, see Set up AI SEO MCP and Set up AI SEO Agent Skills.