grok-bot
This MCP server lets Claude drive the Grok Bot desktop app's chat UI to send messages, read replies, and manage which bot is open.
Send a message to the current or named bot, optionally waiting up to 600 seconds for a reply (default 120; 0 means don't wait).
Read the latest 1–50 chat messages (default 10), see whether the bot is still working, and optionally wait for it to become idle.
List available Grok bots and identify which one is currently open.
Switch the Grok Bot app to a different bot by name, partial name, or id.
Trigger Grok Bot actions indirectly, since it can browse the web, make phone calls, send email, and run routines in response to messages.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@grok-bot Ask my Grok bot to summarize today's AI news and wait for the reply"
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 Bot ↔ Claude bridge
An MCP server that lets Claude drive the Grok Bot desktop app (v0.79.4) on this PC.
Grok Bot has no public API, so the bridge starts the app with Chromium's DevTools port
(127.0.0.1:9333, local only) and operates its chat window directly: it types into the
prompt box, presses Enter, and reads replies back from the transcript. Replies are "done"
when the app's own announcement changes from "bot is working" to "bot replied".
Unofficial. Not made or supported by Grok Bot. Windows only for now; Node 22+.
Install
git clone https://github.com/harkawataryan/grok-bridge.git
cd grok-bridge
npm installInstall and sign in to Grok Bot first. The bridge looks for it at
%LOCALAPPDATA%\Programs\Grok Bot\Grok Bot.exe. Set GROK_BOT_EXE if it's somewhere else,
and GROK_CDP_PORT to use a debug port other than 9333.
Related MCP server: Grok Web MCP
Tools
Tool | What it does |
| Send a message (optionally to a named bot) and wait for the reply (default 120 s) |
| Read the last N messages; can wait until the bot is idle |
| List bots, which one is open, and whether it's working |
| Switch to another bot |
| grok_window | Show the Grok Bot window (to watch or take over) or hide it again |
If Grok Bot isn't running, or was started normally without the debug port, the bridge (re)starts it with the port. You stay signed in.
Runs hidden. When the bridge starts Grok Bot, the window starts hidden: no pop-up and no
taskbar button. It's also launched with Chromium's background throttling off, so hidden replies
arrive at full speed. To see it, ask Claude to show it (grok_window) or just open Grok Bot
from the Start menu. Set GROK_HIDDEN=0 to launch it visibly instead. If you already have
Grok Bot open (with the debug port), the bridge leaves your window alone.
Claude Desktop / Claude Code (local, stdio)
"mcpServers": {
"grok-bot": { "command": "node", "args": ["<this folder>/server.mjs"] }
}Claude Code (also what the Claude Desktop Code tab uses):
claude mcp add --scope user grok-bot -- node "<this folder>/server.mjs"
The Chat tab reads claude_desktop_config.json; the Code tab reads Claude Code's own config
(~/.claude.json), so register it in both if you use both. Either way, fully quit and reopen
Claude Desktop (or start a new session) afterwards, because running sessions don't pick up new servers.
Claude on web / phone
Two options:
Through your desktop (recommended, nothing exposed): keep Claude Desktop running on this PC with the bridge installed, and talk to it from your phone via Remote Control / Dispatch. The phone sends instructions to the desktop session, and the desktop session calls the bridge.
As a custom connector (works in claude.ai chats and the mobile app): run the bridge in HTTP mode behind a tunnel, then add
https://<your-host>/mcp/<token>in claude.ai → Settings → Connectors → Add custom connector. The token is in.bridge-tokenand is the only thing protecting access. Anyone with the URL can make your bot place calls and send email, so keep it private. To rotate it, delete.bridge-tokenand restart the bridge.Cloudflare Tunnel on your own domain (free):
cloudflared tunnel login # approve your domain in the browser cloudflared tunnel create grok-bridge cloudflared tunnel route dns grok-bridge grok.example.com~/.cloudflared/config.yml:tunnel: <tunnel-id> credentials-file: C:\Users\<you>\.cloudflared\<tunnel-id>.json ingress: - hostname: grok.example.com service: http://127.0.0.1:8790 - service: http_status:404remote.ps1keeps the bridge (HTTP mode) and the tunnel running and restarts either one if it stops;remote-start.vbsstarts it with no window. Run it at login with a scheduled task (not a shell you might close, or an app like Claude Desktop, which takes its child processes down with it when it restarts):$a = New-ScheduledTaskAction -Execute wscript.exe -Argument '"<this folder>\remote-start.vbs"' $s = New-ScheduledTaskSettingsSet -ExecutionTimeLimit 0 -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -MultipleInstances IgnoreNew Register-ScheduledTask 'Grok Bridge (remote)' -Action $a -Trigger (New-ScheduledTaskTrigger -AtLogOn -User $env:USERNAME) -Settings $s Start-ScheduledTask 'Grok Bridge (remote)'Logs go to
logs/. The PC has to be on and awake for the connector to work. (ngrok works too, e.g.ngrok http 8790 --url <your-static-domain>.)
Notes / limits
It drives the UI, so a Grok Bot update that renames its CSS classes (
sand-prompt-field,sand-transcript-row, …) can break it. The selectors are ingrok.mjs.While the debug port is open, any program on this PC can control the Grok Bot window. It is never reachable from the network.
There's no "stop the bot" tool: the app has no stop control I could verify.
node test-client.mjsruns a quick self-test, which sends one test message to the open bot.
Available Tools
4 toolsgrok_list_botsList Grok botsA
List the bots in the Grok Bot app and which one is open.
Inputs: no named parameters.
grok_readRead Grok Bot chatA
Read the latest messages in a Grok Bot chat (also shows whether the bot is still working).
Inputs: bot, count, wait_until_idle_seconds.
grok_select_botOpen a Grok botB
Switch the Grok Bot app to a different bot.
Inputs: bot (required).
grok_sendMessage Grok BotA
Send a message to a bot in the Grok Bot desktop app and wait for its reply. Grok Bot is an agent that can browse the web, make phone calls, send email, and run routines, so it may act on the message. If it is still working when the wait ends, call grok_read later to get the rest.
Inputs: message (required), bot, wait_seconds.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct action on a distinct concern: sending a message, reading messages, listing bots, and switching the active bot. There is no realistic way to confuse send with read, or list_bots with select_bot, since the descriptions explicitly contrast them (e.g. grok_send tells the agent to use grok_read afterward).
All four tools use a single predictable scheme: the `grok_` prefix followed by a lowercase snake_case verb, with `_bots` appended when operating on the bot list. There is no mixing of camelCase, bare verbs, or alternative prefixes.
Four tools is a lean but coherent surface for a desktop-app bridge, and each one earns its place (send/read for chat, list/select for bot management). It is on the thin side, and a couple more operations (e.g. starting a new chat) would round it out.
The core loop of listing/selecting a bot and sending/reading messages is covered, but there is no way to start a new chat/conversation, cancel or interrupt a running bot, or discover existing chats beyond the 'latest messages' read. These are notable gaps an agent could hit when the current chat is not the one it wants.
Maintenance
Related MCP Connectors
Control your Chrome from chat: open websites, read what's on the page, click buttons, and fill in f…
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Claude Code to send prompts to Claude Desktop using macOS automation and AppleScript. Supports conversation management and configurable response polling, though reading responses back is limited by Electron's accessibility APIs.21MIT
- FlicenseNot gradedqualityDmaintenanceAutomates Grok web interface to provide chat, web search, and conversation management via MCP, supporting multiple accounts and local/remote deployment.-
- AlicenseAqualityCmaintenanceLets Claude Code and Codex steer each other's live desktop chats on Windows via UI Automation. List and read chats, send messages or mid-turn steers, and pause, resume or edit Codex goals.7MIT
- AlicenseAqualityCmaintenanceLets MCP clients such as Claude Code, Codex, Cursor, and VS Code drive the Grok Bot desktop app on macOS by listing the user's bots, reading their chats, sending them messages, and answering their multiple-choice questions locally without API keys. All actions run live in the real app via the macOS Accessibility API, with no network calls, telemetry, or dependencies.41MIT