adityakarnam/open-context repository overview

⁠open-context

Portable AI context — import, manage, and export your conversation history across every AI platform.

open-context lets you migrate your full chat history from ChatGPT or Gemini into Claude-compatible formats, and gives Claude persistent memory through a built-in MCP server. This single Docker image bundles the React web UI, REST API server, and MCP server together.

⁠What is open-context?

When you switch AI assistants, you lose everything — your communication style, your background, your conversation history. open-context solves that by:

1. Importing your chat history from ChatGPT (Gemini support coming)
2. Analyzing your patterns with a local LLM (Ollama) to generate preferences and memory
3. Exporting to Claude, ChatGPT custom instructions, or Gemini formats
4. Persisting new context across every Claude conversation via an MCP server

Everything runs locally. Your data never leaves your machine.

⁠How to use this image

⁠Quick start — web UI + REST API

docker run -p 3000:3000 \
  -v open-context-data:/root/.opencontext \
  adityakarnam/open-context:latest

Open http://localhost:3000⁠.

⁠With a specific version (recommended)

docker run -p 3000:3000 \
  -v open-context-data:/root/.opencontext \
  adityakarnam/open-context:0.0.1

⁠MCP server (stdio mode for Claude Code / Claude Desktop)

Override the default command to run the MCP server instead:

docker run -i --rm \
  -v open-context-data:/root/.opencontext \
  adityakarnam/open-context:latest \
  node dist/mcp/index.js

⁠Connect to Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "open-context": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "open-context-data:/root/.opencontext",
        "adityakarnam/open-context:latest",
        "node", "dist/mcp/index.js"
      ]
    }
  }
}

⁠Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "open-context": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "open-context-data:/root/.opencontext",
        "adityakarnam/open-context:latest",
        "node", "dist/mcp/index.js"
      ]
    }
  }
}

⁠With docker compose

services:
  open-context:
    image: adityakarnam/open-context:latest
    ports:
      - "3000:3000"
    volumes:
      - open-context-data:/root/.opencontext

volumes:
  open-context-data:

⁠Persistent storage

All data is stored in the mounted volume at /root/.opencontext — no browser localStorage is used.

⁠Environment variables

host.docker.internal resolves to the host machine from inside the container. On Linux, add --add-host=host.docker.internal:host-gateway.

⁠MCP tools

Once connected, Claude gains these persistent memory tools:

⁠Image variants

⁠License

MIT — github.com/adityak74/open-context⁠