# githippo

> githippo is an open-source MCP server for knowledge and memory. Long-term memory for Claude as Markdown in a git repo you own, built to survive compaction. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux
- **Repository:** https://github.com/anxovatomicaes/githippo
- **MCP Registry name:** io.github.AnxovatomicaES/githippo
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-16

## About

Every memory in githippo is a Markdown file committed to a git repository you control, so each one can be read, diffed and reverted. Recall is hybrid semantic search over those files plus a knowledge graph built from wikilinks, with a multilingual embedder running locally by default, so a question in Spanish can find notes written in English. Tool overhead is given as about 790 tokens per turn.

Its selling point is surviving context compaction in three ways. Pinned core memory rides in the MCP server instructions, which sit in the system prompt. For Claude Code, a PreCompact hook builds a checkpoint (goal, todos, files changed, where it stopped) from the transcript with no LLM call, and a SessionStart hook injects it after compaction. A checkpoint tool does the same for any client. Superseded facts move to a dated history section, and history at a given date gives time travel from git.

A compliance guard blocks private keys, API tokens, card and IBAN numbers and several national ID formats before they enter git history, though the README says it is a backstop and not DLP. Install is a one-line script with no account, and an optional sync creates a private GitHub repository. It can also be served as a self-hosted remote MCP for claude.ai.

## Features

- **Git-backed Markdown:** Stores each memory as a file and commit you can read and revert.
- **Hybrid recall:** Combines semantic search, keyword matching and one-hop link following.
- **Compaction survival:** Uses core memory in instructions, hook-built checkpoints and a checkpoint tool.
- **Secret guard:** Blocks keys, tokens, card numbers and ID numbers before they are committed.
- **Duplicate detection:** Flags updates and possible contradictions rather than silently merging them.
- **Sync and remote:** Optional private GitHub sync and self-hosted remote MCP for claude.ai.

## Good for

- Keep project preferences across long Claude Code sessions
- Restore task state after context compaction
- Search past notes in a different language
- See what was true in a project at a past date

## Install

### Claude Code (Terminal)

```sh
claude mcp add githippo -- npx -y https://github.com/AnxovatomicaES/githippo/releases/download/v3.9.3/githippo-3.9.3.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "githippo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AnxovatomicaES/githippo/releases/download/v3.9.3/githippo-3.9.3.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "githippo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AnxovatomicaES/githippo/releases/download/v3.9.3/githippo-3.9.3.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "githippo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AnxovatomicaES/githippo/releases/download/v3.9.3/githippo-3.9.3.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "githippo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AnxovatomicaES/githippo/releases/download/v3.9.3/githippo-3.9.3.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "githippo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AnxovatomicaES/githippo/releases/download/v3.9.3/githippo-3.9.3.mcpb"
      ]
    }
  }
}
```

## Tools

- `recall`: Retrieve memories, with a brief mode of one-line refs
- `checkpoint`: Save or restore task state across context loss
- `maintain`: Report memory health and possible contradictions
- `history`: Time travel to memory state at a given date

## FAQ

### Where is my data stored?

In a local vault that is a git repository you own, by default at ~/.githippo/vault.

### Does it need an account?

No. The README says the install needs no account or token.

### How does it survive compaction?

Through core memory in the system prompt, a hook-built checkpoint for Claude Code, and a checkpoint tool for any client.

### Does it catch every secret?

No. The README says encoded or split secrets can still get through and it is not data loss prevention.

### Is githippo free?

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

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

Run this command in your terminal: claude mcp add githippo -- npx -y https://github.com/AnxovatomicaES/githippo/releases/download/v3.9.3/githippo-3.9.3.mcpb

### What are the best alternatives to githippo?

The closest alternatives to githippo are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## 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.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

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