chatgpt2md
by NextStat·★ 16·Score 42
ChatGPT to Markdown converter with full-text search and MCP server for accessing conversations in Claude.
Overview
chatgpt2md is a Rust-based CLI tool that converts ChatGPT export data into organized Markdown files with a built-in full-text search index. It provides an MCP server with three tools: search_conversations for full-text searching across all chats, get_conversation for reading specific conversations, and list_conversations for browsing chats by date. The tool supports both automatic and manual configuration for Claude Desktop and Claude Code, with one-command installation for seamless integration.
Try asking AI
After installing, here are 5 things you can ask your AI assistant:
When to choose this
Choose this tool if you're migrating from ChatGPT to Claude and need to maintain access to your conversation history with full search capabilities.
When NOT to choose this
Don't choose this if you need to process exports from platforms other than ChatGPT or if you require bidirectional sync between ChatGPT and Claude.
Tools this server exposes
3 tools extracted from the READMEsearch_conversationsFull-text search across all conversations by keywords
get_conversationRead the complete text of a specific conversation
list_conversationsBrowse conversations by year and/or month
Comparable tools
Installation
Installation
Quick Install
cargo install --git https://github.com/NextStat/chatgpt2mdBinary Installation
- Download the appropriate binary for your platform from [Releases](https://github.com/NextStat/chatgpt2md/releases)
- Extract and move to PATH:
``bash tar xzf chatgpt2md-*.tar.gz sudo mv chatgpt2md /usr/local/bin/ ``
Claude Configuration
chatgpt2md install --index ./chatgpt_chats/.index --chats ./chatgpt_chatsManual Claude Desktop Configuration
Edit Claude Desktop config file:
- **macOS:**
~/Library/Application Support/Claude/claude_desktop_config.json - **Windows:**
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"chatgpt-history": {
"command": "/path/to/chatgpt2md",
"args": ["serve", "--index", "/path/to/chatgpt_chats/.index", "--chats", "/path/to/chatgpt_chats"]
}
}
}FAQ
- What file formats does chatgpt2md support?
- It supports both ZIP exports directly from ChatGPT and the JSON format (conversations.json) inside the ZIP.
- Can I exclude system messages from the export?
- Yes, use `--include-system` flag to include system/tool messages, otherwise they are excluded by default.
Compare chatgpt2md with
Last updated · Auto-generated from public README + GitHub signals.