OpenSEO
Back to Docs

Install the OpenSEO plugin for Codex

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

The OpenSEO plugin bundles OpenSEO MCP and all twelve SEO Agent Skills into one install. This is the preferred way to set up OpenSEO 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 OpenSEO and guide you through sign-in.

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

Ask: “Use OpenSEO to check my connection and list my projects.” The check uses no OpenSEO 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 every-app/open-seo
codex plugin add openseo@openseo
codex mcp login openseo

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

Codex connects OpenSEO MCP at https://app.openseo.so/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 openseo

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 openseo@openseo

Troubleshooting

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

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

codex mcp logout openseo
codex mcp login openseo

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 OpenSEO plugin for Claude instead. For Cursor or an API key setup, see Set up OpenSEO MCP and Set up OpenSEO Agent Skills.