AkaiSEO
Back to Docs

Install the AkaiSEO plugin for Codex

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

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

Install

Run these commands in your terminal:

codex plugin marketplace add MohammedIbraAhmed/akaiseo
codex plugin add akaiseo@akaiseo
codex mcp login akaiseo

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

Codex connects AkaiSEO MCP at https://app.akaiseo.com/mcp and enables nine skills:

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

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 or remove

codex plugin marketplace upgrade akaiseo
codex plugin remove akaiseo@akaiseo

Troubleshooting

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

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

codex mcp logout akaiseo
codex mcp login akaiseo

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

This plugin is for Codex CLI. For Claude Code, use the AkaiSEO plugin for Claude Code instead. For Claude Desktop, Cursor, Codex Desktop, or an API key setup, see Set up AkaiSEO MCP and Set up AkaiSEO Agent Skills.