# Context Bridge

> Context Bridge is an open-source MCP server for knowledge and memory. Search your past Claude and ChatGPT conversations locally, with citations. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Repository:** https://github.com/modernfarm-hub/context-bridge
- **MCP Registry name:** io.github.ModernFarm-hub/context-bridge
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

Context Bridge answers questions like what you decided about Kafka retries last week by searching your own chat history, and every answer links to the original web conversation or to an exact passage in a local transcript. The index lives on your computer and the project says there is no telemetry.

You feed it exports: official ChatGPT and Claude.ai ZIP files, plus automatic discovery of Claude Code transcripts and ChatGPT desktop or Codex sessions for projects you approve. Separate profiles keep personal and work libraries apart, and account metadata is compared so a different account's export cannot silently replace yours.

Search uses SQLite FTS5 with stemming and title weighting by default. An opt-in hybrid mode adds a MiniLM embedding model of about 90 MB; on the README's synthetic 30-conversation test it raised top-1 accuracy from 3.3% to 86.7%, which the author notes is not a real-library accuracy claim. It is a beta (0.8.0b1) for macOS and Linux.

## Features

- **Cited results:** Each hit links to the original conversation or the exact local passage.
- **Multiple sources:** ChatGPT and Claude.ai exports, Claude Code transcripts and Codex sessions.
- **Local-first:** Search stays on your machine with no telemetry.
- **Optional semantic search:** A hybrid mode adds embeddings for paraphrased queries.
- **Profiles:** Separate libraries for personal and work accounts.

## Good for

- Recover a decision made in an earlier chat
- Find the source conversation for a snippet of advice
- Search across Claude and ChatGPT history from one place
- Keep work and personal chat archives separate

## Install

### Claude Code (Terminal)

```sh
claude mcp add context-bridge -- uvx context-bridge-local
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "context-bridge": {
      "command": "uvx",
      "args": [
        "context-bridge-local"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "context-bridge": {
      "command": "uvx",
      "args": [
        "context-bridge-local"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "context-bridge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "context-bridge-local"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "context-bridge": {
      "command": "uvx",
      "args": [
        "context-bridge-local"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "context-bridge": {
      "command": "uvx",
      "args": [
        "context-bridge-local"
      ]
    }
  }
}
```

## Tools

- `context_search`: Search imported conversations and return cited results
- `context_read`: Read the surrounding turns of a returned record by record_id

## FAQ

### What platforms does it support?

macOS and Linux, Python 3.9 to 3.13.

### Is any data sent out?

The README says search stays on your computer and there is no telemetry.

### What licence is it?

Apache-2.0.

### How do I add a ChatGPT history?

Download the official export ZIP and run the import chatgpt command on it.

### Is Context Bridge free?

Yes. Context Bridge is open source, so you can use and self-host it for free.

### How do I add Context Bridge to Claude Code?

Run this command in your terminal: claude mcp add context-bridge -- uvx context-bridge-local

### What are the best alternatives to Context Bridge?

The closest alternatives to Context Bridge are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/context-bridge
