Skip to content
MCP server

Genealogy

Local genealogy assistant that reads GEDCOM and BegatAll files without uploading them

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, Windows, macOS
Runs
Locally
Version
1.4.1
Listing updated
2 days ago

About Genealogy

Genealogy is a free MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Genealogy MCP runs entirely on your computer over stdio. It loads one family file at a time (.ged, .gedcom, a zip containing one, a .begatallx package, a BegatAll folder with sqlite.db, or a legacy .begatall or .bgallged database) and answers questions about the people in it: search, relationships, ancestors, descendants, timelines, sources, gaps and research ideas. It can also show photos stored in the file and linked documents from the package.

The site says nothing is uploaded and the server does not call the internet, though the AI app you connect may send tool results to its own cloud. Living people appear in answers unless you set GENEALOGY_MCP_HIDE_LIVING, while export leaves them out by default.

Reading never changes the file. Edits stay in a private copy, and writing back to the original is off unless you set GENEALOGY_MCP_ALLOW_COMMIT. It needs Node.js 18 or newer and ships native builds for Windows x64, Linux x64 and macOS Intel and Apple silicon.

Install

Run in a terminal

claude mcp add genealogy -- npx -y @eacpartners/genealogy-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "genealogy": {
      "command": "npx",
      "args": [
        "-y",
        "@eacpartners/genealogy-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "genealogy": {
      "command": "npx",
      "args": [
        "-y",
        "@eacpartners/genealogy-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "genealogy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@eacpartners/genealogy-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "genealogy": {
      "command": "npx",
      "args": [
        "-y",
        "@eacpartners/genealogy-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "genealogy": {
      "command": "npx",
      "args": [
        "-y",
        "@eacpartners/genealogy-mcp"
      ]
    }
  }
}

Configuration

  • GENEALOGY_MCP_HIDE_LIVINGSet to 1 to hide living people in read tools. true, yes, and on also hide them. Leave unset to keep the default, which shows living people. GENEALOGY_HIDE_LIVING is the same switch. This stays on your computer. export_session still leaves living people out unless you opt out there.
  • GENEALOGY_MCP_SHOW_LIVINGOlder show switch. Set to 1 to include living people in read tools and to keep them in export_session. Set to 0 to hide them. A hide switch wins when both are set. Leave unset to use the hide switch, the config file, or the default.
  • GENEALOGY_MCP_ALLOW_COMMITSet to 1 to allow commit_session and restore_backup to replace a file on this computer after confirmation. Leave unset to keep the default, which refuses those writes.

What it does

Local-only processing
Your file stays on your computer and the server makes no internet calls.
Several file formats
Reads GEDCOM, BegatAll packages and legacy BegatAll databases.
Family questions
Relationships, ancestors, descendants, timelines and unsourced events.
Research gaps
Points out what is missing and what to look up next.
Photos and documents
Shows images and linked documents from the file.
Living-person control
Hide living people with an environment variable or config; export omits them by default.

Good for

  • Summarise who is in a family tree file
  • Build a timeline for an ancestor and flag unsourced events
  • Find gaps to guide the next round of research
  • List and view photos linked to a person

Pricing

Free

Proprietary free-to-use software; copying, modifying and redistributing are not allowed

Prices change. Check eacpartners.com before you buy.

Genealogy FAQ

Does my file get uploaded?

The site says no. The server runs locally and does not upload your file or send analytics, though your AI app may send tool results to its own service.

Can it edit my file?

Edits stay in a private copy; updating the original is off unless GENEALOGY_MCP_ALLOW_COMMIT is set and you confirm.

What do I need to run it?

Node.js 18 or newer; launch with npx -y @eacpartners/genealogy-mcp@1.4.1.

Does it work with the ChatGPT website?

No. The website cannot start a local program; use the ChatGPT desktop app with Codex or the Codex CLI.

Is Genealogy free?

Yes. Genealogy is free to use.

How do I add Genealogy to Claude Code?

Run this command in your terminal: claude mcp add genealogy -- npx -y @eacpartners/genealogy-mcp

What are the best alternatives to Genealogy?

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

Alternatives to Genealogy

  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