How do I use Grok-MCP-Claude?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Grok-MCP-Claude Generate an image of a sunset over mountains" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Grok-MCP-Claude

by yukincom

Overview Schema Related Servers Score Discussions

Python

Remote

Grok-MCP-Claude

Grok MCP server optimized for Claude Desktop — clean, single-file implementation using xAI's Grok for real-time web/X search and image generation.

Concept

Claude thinks, Grok searches.

Claude Desktop handles conversation, memory, and reasoning. Grok provides what Claude can't — real-time web search, X (Twitter) search, and image/video generation.

sucsess

Related MCP server: grok-mcp

Features

Tool	Description
`grok_search`	Real-time web and X (Twitter) search
`grok_chat`	Chat with vision, file, and code execution support
`grok_agent`	Multi-tool agent combining search, code execution, files, and images
`generate_image`	Image generation with img2img support
`generate_video`	Video generation with img2video and video2video support
`manage_files`	Upload, list, retrieve, and delete files on xAI

Requirements

Python 3.10+
xAI API key
Claude Desktop

Installation

git clone https://github.com/yourname/grok-mcp-claude.git
cd grok-mcp-claude
pip install -r requirements.txt

Configuration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "grok": {
      "command": "python",
      "args": ["/path/to/grok-mcp-claude/grok.py"],
      "env": {
        "XAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tool Reference

`grok_search`

Real-time search via web or X (Twitter).

Parameter	Default	Description
`prompt`	required	Search query
`platform`	`"web"`	`"web"` or `"x"`
`model`	`DEFAULT_SEARCH_MODEL`	Model to use
`allowed_targets`	`None`	Whitelist of domains (web) or handles (X)
`excluded_targets`	`None`	Blacklist of domains (web) or handles (X)
`from_date`	`None`	Start date `DD-MM-YYYY` (X only)
`to_date`	`None`	End date `DD-MM-YYYY` (X only)
`include_inline_citations`	`False`	Return inline citations

`grok_chat`

General-purpose chat with optional vision, file, and code execution.

Parameter	Default	Description
`prompt`	required	User message
`model`	`DEFAULT_CHAT_MODEL`	Model to use
`system_prompt`	`None`	System prompt
`file_ids`	`None`	xAI file IDs to attach
`image_paths`	`None`	Local image paths
`image_urls`	`None`	Image URLs
`response_id`	`None`	Previous response ID for stateful chat
`use_code_execution`	`False`	Enable code execution

`grok_agent`

Multi-tool agent. Combine web search, X search, code execution, files, and images freely.

Parameter	Default	Description
`prompt`	required	User message
`model`	`DEFAULT_SEARCH_MODEL`	Model to use
`use_web_search`	`False`	Enable web search
`use_x_search`	`False`	Enable X search
`use_code_execution`	`False`	Enable code execution
`allowed_targets`	`None`	Whitelist of domains or handles
`excluded_targets`	`None`	Blacklist of domains or handles
`file_ids`	`None`	xAI file IDs to attach
`image_paths`	`None`	Local image paths
`image_urls`	`None`	Image URLs
`system_prompt`	`None`	System prompt
`include_inline_citations`	`False`	Return inline citations
`max_turns`	`None`	Max search iterations

`generate_image`

Generate images. Pass image_path or image_url for img2img.

Parameter	Default	Description
`prompt`	required	Generation prompt
`model`	`DEFAULT_IMAGE_MODEL`	Model to use
`n`	`1`	Number of images
`image_path`	`None`	Local image for img2img
`image_url`	`None`	Image URL for img2img
`aspect_ratio`	`None`	e.g. `"16:9"`, `"1:1"`, `"9:16"`

`generate_video`

Generate videos from text, image, or video.

Parameter	Default	Description
`prompt`	required	Generation prompt
`model`	`DEFAULT_VIDEO_MODEL`	Model to use
`image_path` / `image_url`	`None`	Source image for img2video
`video_path` / `video_url`	`None`	Source video for video2video
`duration`	`None`	Duration in seconds
`aspect_ratio`	`None`	Aspect ratio
`resolution`	`None`	Resolution

`manage_files`

Manage files on xAI.

Action	Required params	Description
`upload`	`file_path`	Upload a file
`list`	—	List uploaded files
`get_info`	`file_id`	Get file metadata
`get_content`	`file_id`	Get file content
`delete`	`file_id`	Delete a file

Models

DEFAULT_CHAT_MODEL   = "grok-4-1-fast-non-reasoning"
DEFAULT_SEARCH_MODEL = "grok-4-1-fast-reasoning"
DEFAULT_IMAGE_MODEL  = "grok-imagine-image"
DEFAULT_VIDEO_MODEL  = "grok-imagine-video"

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yukincom/grok-mcp-claude'

If you have feedback or need assistance with the MCP directory API, please join our Discord server