🧠 Grok It

🌐 Languages: English | 简体中文

✨ What is Grok It?

Grok It is a Codex / Claude Code plugin for Agents. It connects Grok / xAI capabilities to local Agent workflows through a local MCP server.

After installation, Agents can use this plugin to access:

• 🔎 X Search / x_search: use Grok subscription-backed X / Twitter search for recent or real-time social context.
• 🖼️ Image generation: let Agents call Grok / xAI image generation and cache generated files by default.
• 🎬 Video generation: let Agents generate short videos, returning remote URLs by default with optional local caching.
• 🔐 Authentication support: use Grok OAuth login, with XAI_API_KEY as a fallback option.

🧩 Use Cases

• 📰 Search recent X discussions, trends, sentiment, or account activity.
• 🎨 Generate images, illustrations, creative assets, or visual references from prompts.
• 📹 Generate short video assets from prompts or reference images.
• 🤖 Add Grok-powered tools to Codex / Claude Code Agents.

📦 What is included?

This plugin directory includes:

• 🛠️ .mcp.json: registers the local grok-it MCP server.
• 🧠 skills/grok-tools/: guidance that tells Agents when and how to use Grok tools.
• 🧾 .codex-plugin/plugin.json: Codex plugin manifest.
• 🧾 .claude-plugin/plugin.json: Claude Code plugin manifest.

🚀 How to Install This Plugin

Official marketplace: Misty-Star/grok-it-mcp; plugin name: grok-it; marketplace name: grok-it.

📦 Install the npm CLI first

Install the local MCP server CLI globally:

npm install -g grok-it-mcp

🔐 Log in to Grok

Open the browser-based OAuth login flow:

grok-it-mcp login --open

🖥️ Remote / headless sessions

On servers, containers, or SSH sessions where no browser is available, the login flow prints the authorization URL instead of opening a browser.

Important: the loopback listener still runs on the remote machine at 127.0.0.1:8153. The xAI redirect needs to reach that listener, so opening the URL on your laptop will fail unless you forward the port:

ssh -N -L 8153:127.0.0.1:8153 user@remote-host
grok-it-mcp login --loopback

You can also check local auth and run quick generation/search commands from the terminal:

grok-it-mcp status
grok-it-mcp search "xAI news"
grok-it-mcp image-gen "a neon robot in Shanghai" --aspect-ratio 16:9
grok-it-mcp video-gen "waves crashing at sunset" --duration 6 --json

CLI aliases with underscores are also supported: image_gen and video_gen.

🛒 Codex CLI: add the marketplace once

codex plugin marketplace add Misty-Star/grok-it-mcp

⚡ Codex CLI: install the plugin

codex plugin add grok-it@grok-it

🔄 Codex CLI: update the marketplace

codex plugin marketplace upgrade grok-it

🧩 Claude Code: add the marketplace once

/plugin marketplace add Misty-Star/grok-it-mcp

⚡ Claude Code: install the plugin

/plugin install grok-it@grok-it

🔄 Claude Code: update the marketplace

/plugin marketplace update grok-it

🔑 Authentication

After installation, the Agent will usually check auth status first:

• ✅ Existing OAuth login: Grok tools can be used directly.
• 🔐 Not logged in: start Grok OAuth with grok_login.
• 🗝️ API key mode: provide an xAI API key through XAI_API_KEY.

Default local paths (resolved inside the MCP server/CLI, not via plugin JSON placeholders):

• 🧾 Token store: ~/.grok-it/auth.json
• 📁 Artifact cache: ~/.grok-it/artifacts

🧰 Agent Tools

• grok_auth_status: check OAuth / API-key availability without exposing secrets.
• grok_login: start or complete Grok OAuth login.
• grok_x_search: search X / Twitter with Grok.
• grok_image_generate: generate images and cache image files by default.
• grok_video_generate: generate videos, returning remote URLs by default with optional local caching.

🧪 npm CLI commands

Besides starting the MCP server with no arguments, the npm binary exposes:

• grok-it-mcp image-gen <prompt> / image_gen: generate image(s). Useful flags: --prompt, --model, --aspect-ratio, --resolution, --n <1-4>, --no-cache, --json.
• grok-it-mcp video-gen <prompt> / video_gen: generate video. Useful flags: --prompt, --model, --image-url, --reference-images <url1,url2>, --duration <1-30>, --aspect-ratio, --resolution, --cache-video <true|false>, --json.