grok-bot-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

grok-export-tool
Export Grok Bots and regular chats from the grok.com account already signed in on this machine. A local CLI, a stdio MCP server, and an Agent Skill. Fully local, no API key. It reads history you already have, and does not send new chats.
Each Bot is saved with its roster, full transcript, and attachments. Regular chats go to a second folder. The MCP server and skill let OpenCode, Claude Code, Codex, and others query the Bot archive.
Features · Quick start · Tutorial · MCP · Agent skills · Output layout · Contact · Donate
Features
CLI.
grok-bot-export.pyexports Bots, regular chats, or both (--mode bot,--mode chat,--mode all).--messages-onlyskips Bot attachment downloads.Grok Bots. Roster, full transcript, and attachments (images, video, and other files), in parallel 4 MB chunks.
Regular chats. One Markdown file and one raw JSON file per conversation, plus one combined JSONL file.
Archive. JSONL, readable Markdown, raw JSON, and an index.
MCP. A stdio server with no third-party dependencies:
list_bots,get_bot,search. It reads the Bot archive only.Skill.
.claude/skills/grok-export/is an Agent Skill for Claude Code, OpenCode, and other agents that load that folder.
Bot history goes over grok.com’s bot WebSocket. Regular chats go over grok.com’s app-chat HTTP API. HTTP 429 responses are retried. The MCP server does not index a chat export. Open those files, or point an agent at the folder.
Related MCP server: receipts
Quick start
git clone https://github.com/LofiSu/grok-export-tool.git
cd grok-export-tool
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txtPython 3.9 or newer. Dependencies: websocket-client and cryptography (requirements.txt). On Windows, automatic cookie decryption also needs pywin32. The MCP server uses the standard library only.
python3 grok-bot-export.py # Grok Bots, messages and attachments
python3 grok-bot-export.py --messages-only # Grok Bots, text only
python3 grok-bot-export.py --mode chat # regular Grok chats
python3 grok-bot-export.py --mode all # bothShell wrappers: ./export.sh, ./export-messages.sh, and ./export-chat.sh.
Platform | Cookie login |
macOS | Keychain item Chrome Safe Storage. Profiles scanned: Default, Profile 1, Profile 2. |
Windows | DPAPI when |
Linux | Legacy fixed key or plaintext only. If that fails, use |
python3 grok-bot-export.py --cookie "sso=...; sso-rw=..."Copy sso and sso-rw from your own browser’s DevTools. Do not paste those values into an issue, a chat, or git.
Progress lines are in Chinese. Output goes to ~/Downloads/ unless you pass a directory. Steps are in the tutorial.
Tutorial
The same guide, in both languages, on the site and in the repo: install, each export mode, the archive, MCP, skills, and troubleshooting.
English: docs/guide.md · on the site
中文: docs/guide.zh-CN.md · 网站上的教程
MCP
grok-bot-mcp.py speaks MCP over stdio and does not open a network connection. Pass the Bot export directory. If you omit the path, it uses the newest ~/Downloads/grok-bot-export-* directory by modification time.
OpenCode’s current config schema puts servers under mcp.servers. In ~/.config/opencode/opencode.json (or a project opencode.json):
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"grok-bot": {
"type": "local",
"command": [
"python3",
"/absolute/path/grok-bot-mcp.py",
"/absolute/path/grok-bot-export-YYYYMMDD"
]
}
}
}
}Tool | Role |
| Names, ids, message counts, last active time |
| One bot, by name, id fragment, or folder prefix such as |
| Case-sensitive substring on message text, with neighboring lines. |
Claude Code, Codex, and Cursor launch the same process from their own config files. Paths and examples are in the guide.
Agent skills
The skill is .claude/skills/grok-export/SKILL.md. The name is grok-export.
Claude Code reads
.claude/skills/in the project.OpenCode reads that folder too, or you can set
"skills": [".claude/skills"].Codex, Copilot, Gemini CLI, Cursor — copy
grok-export/into the skills directory that agent documents.
Ask the agent to export, or to look something up in the Bot archive.
Output layout
Grok Bots (default, or the Bot half of --mode all):
~/Downloads/grok-bot-export-YYYYMMDD/
AGENTS.md
_index.md
roster.json
01_<bot name>/
meta.json
transcript.json
messages.jsonl
conversation.md
attachments/messages.jsonl is one JSON object per line. Fields: seq, type (message, send-message, user-attachment, event, voice-call), role (user or assistant when the entry has one), content, timestamp, timestampMs, attachment, localFile, event, call.
Regular chats (--mode chat, or the chat half of --mode all):
~/Downloads/grok-chat-export-YYYYMMDD/
_index.md
conversations.jsonl
conversations/
0001_<title>.md
0001_<title>.jsonconversations.jsonl fields: conversationId, title, role, sender, content, timestamp, timestampMs. Chat export records response text and the raw response JSON. It does not download attachment files.
The first argument sets the output directory. With --mode all and a directory, Bots go to that directory and chats go to the same path with -chat appended. The process sets umask 077, then marks directories 0700 and files 0600. Attachment downloads skip a file that is already present and non-empty. --workers defaults to 6 (allowed range 1–32) and applies to Bot attachments. --messages-only is an alias of --skip-attachments and only affects Bots.
Start with _index.md. For a Bot, read conversation.md or messages.jsonl. AGENTS.md in a Bot export is a short map of that folder for an agent.
Disclaimer
Maintained in this public repository by the community. Not published by xAI. grok.com’s interfaces can change without notice. Back up an account you own, and follow grok.com’s terms. Treat the export folder as private. Report vulnerabilities in private, and do not include cookies or transcripts. See SECURITY.md.
Contact
Usage questions, doc fixes, and platform help:
GitHub: github.com/LofiSu
X: X / @su_lofi
Email: lofisuchat@gmail.com
Donate
Sponsor via GitHub Sponsors, or send email.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory, hybrid search and a goal graph for AI agents, over stdio or remote HTTP.
Ingest and search LogsLoom logs from coding agents.
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceSearch and read locally-recorded meeting transcripts over stdio. Read-only, no network. Exposes list_sessions, get_session, and search_transcripts to any MCP client.50 PyPI7MIT
- AlicenseNot gradedqualityBmaintenanceEnables any agent to query the same interview corpus as the UI over stdio, exposing tools to list transcripts, search quoted lines, retrieve verified themes with citations and dropped reasons, and fetch source lines.9 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables searching and retrieving ChatGPT and Claude conversation exports locally, allowing assistants to fetch handoff context and continue conversations through read-only MCP tools.MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to search and retrieve Slack message history from a portable SQLite archive through read-only tools for status, channels, messages, threads, and surrounding context.MIT