ChatGPT Wiki Generator

A tool for processing ChatGPT and Claude conversation exports to generate a comprehensive, navigable personal wiki, that you can chat with via any MCP-compatible client.

🚀 Three easy steps (macOS)

1. Export your conversations

ChatGPT: Export data

Claude: Visit claude.ai → Settings → Export Data

Once you initiate, they may take a couple hours to send you your data

2. Get this project

Clone the repo, or if you don't know how: click the green "Code" button → Download ZIP, then unzip it.

3. Run the setup

Open your Terminal app on your Mac. From within the unzipped folder of this repo, drag the setup.sh file into Terminal and press Enter.

What this will do

• Check your environment and install dependencies automatically
• Prompt for your OpenRouter API key
• Guide you through extracting your ChatGPT export
• Process all conversations and generate summaries
• Create your wiki structure
• Configure Claude Desktop automatically

Show full manual instructions (advanced)

Manual Setup

If you prefer to run the steps manually, follow the instructions below.

Creating your wiki

Prerequisites

If you haven't already, install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

1. Setup Instructions

Clone the repository:

git clone <repository-url>
cd wiki-memory

then:

Install dependencies with uv:

uv sync

Set your openrouter api key: Create a new file in this directory called .env, that looks like this, with your filled in openrouter key:

OPENROUTER_API_KEY="your-key-here"

2. Download chatgpt history

• Visit https://chatgpt.com/#settings/DataControls
• Click Export Data. You'll get an email with the file.
• Download the zip file, extract it, and rename it to chatgpt_dump
• Move that folder to within this folder. You can replace / merge what's here.

3. Generate full conversation markdown files

Run:

uv run generate_conversations_by_date.py chatgpt_dump/conversations.json

4. Add summaries to the conversation markdown files

Run:

uv run add_conversation_summaries.py

5. Extract all summaries to a single file

Run:

uv run extract_conversation_summaries.py

6. Generate a hierarchy, and edit it

uv run generate_hierarchy_from_summaries.py

Check output/working_hierarchy.md, and edit it until you're happy with it. If you want a section to be more fleshed out, put it higher up in the hierarchy.

7. Generate the wiki

Run:

uv run generate_wiki_from_summaries.py

Using the wiki

Viewing and editing it with Obsidian

When the final command above is done, you will finally see output that looks something like this:

output

Install obsidian.

Then, in Obsidian, click File -> Open Vault, and open that directory.

Connecting Claude to it

If you haven't - download Claude https://claude.ai/download, and add the following mcp config to your claude_desktop_config.json:

{
    "globalShortcut": "",
    "mcpServers": {
      "wiki-memory": {
        "command": "uvx",
        "args": [
          "--from",
          "/path/to/repo/wiki-memory/mcp",
          "mcp-wiki-memory"
        ],
        "env": {
          "WIKI_DIRECTORY": "/path/to/repo/wiki-memory/output/obsidian_wiki/v6-pro2"
        }
      }
    }
  }

Of course:

• "/path/to/repo/wiki-memory/output/obsidian_wiki/v6-pro2" should be set to the output from the previous step
• "/path/to/repo/wiki-memory/mcp" should be set to the {cwd}/mcp