# Genome

> Genome is an open-source MCP server for knowledge and memory. Local, offline agent memory with no LLM calls on write and an auditable record. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/northtekdevs/genome
- **MCP Registry name:** io.github.NORTHTEKDevs/genome
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

Genome's bet is that an agent does not need a language model to decide what to remember. Each message is embedded locally with all-MiniLM-L6-v2 and stored in SQLite or Postgres, so a write takes about 10 ms with no network and no LLM call. Reads use exact cosine search within a tenant's rows, with an optional local cross-encoder reranker. Because embedding is deterministic, replaying the same input reproduces the same store, which the project presents as the basis for auditability.

An opt-in bi-temporal layer records each fact at the time it became true, so a question such as what someone's city was in March can have a different correct answer than what it is now. That step does use one LLM call for belief extraction.

The README is open about its limits: it says accuracy ties Mem0 on LoCoMo and LongMemEval rather than beating it, and the claimed advantages are cost, speed, offline use and the audit record. The MCP server stores memories in `~/.genome/memories.db` and gives the agent four tools. A `genome.verify` command demonstrates the offline write path with outbound sockets blocked.

## Features

- **No-LLM writes:** Messages are embedded locally and stored in about 10 ms with zero model calls.
- **Fully offline:** The write path works with outbound network blocked.
- **Deterministic store:** The same input reproduces the same vectors and content.
- **Point-in-time facts:** Opt-in bi-temporal layer answers what was true at a given date.
- **Local reranking:** An optional cross-encoder reranker improves recall on your machine.
- **Self-check command:** `python -m genome.verify` prints a pass/fail receipt for offline operation.

## Good for

- Give Claude Code persistent memory across sessions with no cloud account
- Run agent memory in an air-gapped environment
- Keep an auditable record of what an agent stored
- Ask what was true about a person at an earlier date
- Compare memory cost against LLM-extraction systems

## Install

### Claude Code (Terminal)

```sh
claude mcp add genome -- uvx genome-memory
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "genome": {
      "command": "uvx",
      "args": [
        "genome-memory"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "genome": {
      "command": "uvx",
      "args": [
        "genome-memory"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "genome": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "genome-memory"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "genome": {
      "command": "uvx",
      "args": [
        "genome-memory"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "genome": {
      "command": "uvx",
      "args": [
        "genome-memory"
      ]
    }
  }
}
```

## Tools

- `remember`: Store a memory
- `recall`: Retrieve relevant memories
- `forget`: Remove a memory
- `reset_memories`: Clear all stored memories

## FAQ

### Does it need an API key?

The MCP server needs no key and keeps data on your machine.

### Where are memories stored?

In ~/.genome/memories.db by default, or Postgres if configured.

### Is it more accurate than Mem0?

No claim of that. The README says answer accuracy ties Mem0 on the benchmarks it ran.

### How do I install it?

pip install "genome-memory[mcp]", then add the genome-mcp command to your client config.

### Is Genome free?

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

### How do I add Genome to Claude Code?

Run this command in your terminal: claude mcp add genome -- uvx genome-memory

### What are the best alternatives to Genome?

The closest alternatives to Genome are Codebase Memory, XERJ, headroom, omniget and next-ai-draw-io.

## 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.
- [headroom](https://ai-powered.com/mcp/headroom-3): headroom is an open-source MCP server for ai models and llm tooling.
- [omniget](https://ai-powered.com/mcp/omniget): omniget is an open-source MCP server for ai models and llm tooling.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [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.
- [unity-mcp](https://ai-powered.com/mcp/unity-mcp-2): unity-mcp is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/genome
