Skip to content
Conduit

mcp server

grok-it-mcp

Claude Code / Codex plugin for xAI Grok — X search, image & video generation via MCP.

Misty-Star/grok-it-mcpcommunitylistedunreviewed
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • Node.js 20 or newer
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "grok-it-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "grok-it-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 25, 2026

Grok It

Languages: English | 简体中文

What is Grok It?

Grok It is a Codex / Claude Code plugin that connects xAI capabilities to local AI agent workflows through an MCP server. It enables agents to search X/Twitter, generate images and videos, and access Grok models directly from your development environment.

Core capabilities:

  • X Search: Use Grok subscription-backed X/Twitter search for recent social context, trends, and account activity
  • Image generation: Generate images through xAI with automatic local caching
  • Video generation: Create short videos from prompts or reference images
  • OAuth authentication: Secure login flow with API key fallback

Use Cases

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

What's Included

This plugin directory contains:

  • .mcp.json: MCP server registration
  • skills/grok-tools/: Agent guidance for when and how to use Grok tools
  • .codex-plugin/plugin.json: Codex plugin manifest
  • .claude-plugin/plugin.json: Claude Code plugin manifest

Installation

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

Install the npm CLI

npm install -g grok-it-mcp

Log in to Grok

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.

The loopback listener 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 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

Install the plugin:

codex plugin add grok-it@grok-it

Update the marketplace:

codex plugin marketplace upgrade grok-it

Claude Code

Add the marketplace once:

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

Install the plugin:

/plugin install grok-it@grok-it

Update the marketplace:

/plugin marketplace update grok-it

To clone this repo, run the CLI from dist/, or attach the checkout as a local plugin, see the Development Guide.

Authentication

After installation, agents check auth status automatically:

  • Existing OAuth login: Grok tools work directly
  • Not logged in: agents start 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):

  • 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 files by default
  • grok_video_generate: Generate videos, returning remote URLs by default with optional local caching

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). Flags: --prompt, --model, --aspect-ratio, --resolution, --n <1-4>, --no-cache, --json
  • grok-it-mcp video-gen <prompt> / video_gen: Generate video. Flags: --prompt, --model, --image-url, --reference-images <url1,url2>, --duration <1-30>, --aspect-ratio, --resolution, --cache-video <true|false>, --json

Development

To clone this repo, build the CLI locally, or attach the checkout as a local plugin, see the Development Guide.

↑↓ navigate openesc close