How do I read conversations.json from a Claude export?

It is one JSON array with a "chat_messages" list per conversation, and the readable text is inside each message's "content" blocks.

Updated November 15, 2026

What is in the export

On claude.ai, go to Settings → Privacy → Export data. The ZIP you get by email holds three files:

How conversations.json is laid out

Read it by hand

  1. Unzip the export.
  2. Open conversations.json in a viewer that folds JSON. Firefox does this when you drag the file into a tab. A code editor works too.
  3. Search for the conversation title in a "name" field.
  4. Open its chat_messages list and read each message in order: check sender, then read the text of each text block in content.
  5. If content is empty, read the message's own text field instead.

If you use the command line, jq can print every conversation as plain text:

jq -r '.[] | "# \(.name)", (.chat_messages[] | "## \(.sender)",
  ([.content[]? | select(.type == "text") | .text] | join("\n\n")))' conversations.json

Things that trip people up

What projects.json holds

One item per Project: name, description, prompt_template (the project instructions), dates, and docs. Each doc has a filename and its full text in content, so your knowledge files can be saved back out as files.

The faster way

TranscriptTidy does this for the whole export in your browser: one Markdown file per conversation, artifacts as separate files, each Project as a folder. Nothing is uploaded. It is free for your 25 most recent conversations and $9 one-time for everything.

Convert my export