ChatGPT history for Claude

1# ChatGPT history for Claude
2 
3**Search your past ChatGPT conversations directly from Claude Desktop.**
4 
5Switched from ChatGPT to Claude? Now you can ask Claude things like *"What did I discuss about marketing strategy in ChatGPT?"* and get real answers — without going back to ChatGPT.
6 
7![MCP](https://img.shields.io/badge/MCP-Compatible-blue)
8![Python](https://img.shields.io/badge/Python-3.10+-green)
9![License](https://img.shields.io/badge/License-MIT-yellow)
10 
11---
12 
13## Install (macOS)
14 
15**Step 1 — Export your ChatGPT data**
16 
17In ChatGPT: Settings → Data Controls → Export Data. You'll get an email with a `.zip` file.
18 
19**Step 2 — Run the installer**
20 
21Open Terminal (⌘ Space → type "Terminal") and paste:
22 
23```bash
24curl -fsSL https://raw.githubusercontent.com/Lioneltristan/chatgpfree/main/install.command | bash
25```
26 
27Select your export file when prompted. Claude Desktop restarts automatically.
28 
29**Step 3 — Search**
30 
31Ask Claude anything:
32- *"Search my ChatGPT history for Python debugging"*
33- *"What did I discuss about marketing in ChatGPT?"*
34- *"Show me my ChatGPT conversations from January 2024"*
35 
36---
37 
38## What it does
39 
40| Tool | Description |
41|------|-------------|
42| `chatgpt_search` | Full-text search across all conversations with optional date filters |
43| `chatgpt_get_conversation` | Retrieve the full content of any conversation by ID |
44| `chatgpt_list_conversations` | Browse conversations by date with pagination |
45| `chatgpt_stats` | Usage overview: total conversations, messages, monthly activity |
46 
47---
48 
49## Privacy
50 
51Everything runs locally on your machine. Your conversations are never uploaded anywhere.
52 
53- No API keys required
54- No external network calls
55- Open source — read every line of code
56 
57---
58 
59## How it works
60 
61Your ChatGPT export is parsed and indexed in memory using TF-IDF when Claude Desktop starts. When you ask Claude to search your history, it calls the local MCP server which responds instantly from the in-memory index.
62 
63---
64 
65## Requirements
66 
67- macOS
68- Python 3.10+
69- [Claude Desktop](https://claude.ai/download)
70 
71---
72 
73## Manual setup (advanced)
74 
75If you prefer to configure manually, add this to `~/Library/Application Support/Claude/claude_desktop_config.json`:
76 
77```json
78{
79  "mcpServers": {
80    "ChatGPT history": {
81      "command": "uvx",
82      "args": [
83        "--from", "git+https://github.com/Lioneltristan/chatgpfree",
84        "chatgpt-history-mcp",
85        "--export-path", "/path/to/conversations.json"
86      ]
87    }
88  }
89}
90```
91 
92---
93 
94## Troubleshooting
95 
96**No conversations showing up**
97Make sure your export file path is correct. The installer copies it to `~/Library/Application Support/Claude/chatgpt-history/conversations.json`.
98 
99**Claude Desktop not picking up the server**
100Restart Claude Desktop after running the installer. Check that the config file is valid JSON.
101 
102---
103 
104## Roadmap
105 
106- [ ] Publish to PyPI for `uvx chatgpt-history-mcp` (no `--from` needed)
107- [ ] Semantic search with local embeddings
108- [ ] Support for other AI chat exports (Gemini, Copilot)
109 
110---
111 
112MIT — [lionelmorlot.com/chatgpfree](https://lionelmorlot.com/chatgpfree)
113