Grawl
Back to Docs

Install the Grawl plugin for Codex

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

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

Install

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 Grawl 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 Grawl MCP at https://app.grawl.net/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 openseo
codex plugin remove openseo@openseo

Troubleshooting

If the Grawl 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

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