chatgpt-to-claude

Convert your ChatGPT ZIP export into organized Markdown files, ready to use as context in Claude Projects.

---

What it does

When you export your data from ChatGPT, you get a ZIP file with a messy conversations.json inside. This tool parses that file and generates one clean Markdown file per conversation, organized into monthly folders — so you can upload them to a Claude Project and use your full history as context.

claude_export/
├── INDEX.md                  ← full index of all conversations
├── 2026-01/
│   ├── 001_My_first_topic.md
│   └── 002_Another_chat.md
├── 2026-02/
│   └── ...

Each .md file contains the full conversation with roles, timestamps, and all messages.

---

Requirements

• Python 3.8 or higher
• No external libraries needed — standard library only

---

How to use

Option A — Command line (recommended)

1. Export your ChatGPT data from Settings → Data controls → Export data
2. Download the ZIP file ChatGPT sends you by email
3. Place chatgpt_to_claude.py in the same folder as the ZIP
4. Run:

python chatgpt_to_claude.py your_export.zip

You can also pass the conversations.json directly:

python chatgpt_to_claude.py conversations.json

Or if both files are in the same folder, just run:

python chatgpt_to_claude.py

Option B — Google Colab (no coding required)

If you prefer not to use the terminal, open the notebook directly in your browser:

👉 Open in Google Colab ← replace with your Colab link

1. Upload your ChatGPT ZIP file when prompted
2. Click Run all
3. Download the generated claude_export folder

---

Importing into Claude

1. Go to claude.ai and create a new Project
2. Open the project and go to the files section
3. Upload the .md files from your claude_export folder — you can select multiple at once

Tip: If you have a large history, don't upload everything into one project. Organize by topic instead: one project for work, one for coding, one for personal research. Use INDEX.md to decide what goes where.

---

About

Made by Santi Moreno — a Spanish-language channel about AI tools, news, and tutorials.

If this was useful, consider subscribing to @iaconsanti