Skip to content
MCP server

githippo

Long-term memory for Claude as Markdown in a git repo you own, built to survive compaction

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
3.9.3
Listing updated
1 day ago

About githippo

githippo is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "githippo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AnxovatomicaES/githippo/releases/download/v3.9.3/githippo-3.9.3.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "githippo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AnxovatomicaES/githippo/releases/download/v3.9.3/githippo-3.9.3.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • VAULT_DIRMemory vault folder (a git repo). Default: ~/.githippo/vault
  • EMBEDDINGSlocal (default), voyage or none

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free; bring your own git repo

githippo 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 to githippo

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity