Skip to content
MCP server

Genealogy research toolkit

Genealogy MCP server with 179 archive guides, name variants, calendars and tree tools

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.7.1
Listing updated
today

Similar MCP servers

About Genealogy research toolkit

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

Genealogy-mcp is a Python server that runs on your own computer and goes online only for a search you ask for, and only to the one site involved. Its core is a set of record guides for 179 archives and databases in 55 countries, each saying what it holds and how to search it, including which archive holds the records of a historical province today.

The 31 tools handle the awkward parts of family research: name variants across nine transliteration systems, Daitch-Mokotoff matching, Julian, Hebrew and French Republican calendars, dates from church feasts, Church Slavonic numerals, kinship terms in three languages, shared-DNA estimates and drafted archive requests. A match check links a find only with two independent facts beyond the name. It can also read and change a GEDCOM file from MyHeritage, Ancestry, Gramps and others in place, showing each change first and keeping a copy, and it keeps a research log including searches that found nothing.

The author's guides come in several languages, with a Russian version of the README.

Install

Run in a terminal

claude mcp add genealogy-mcp -- uvx genealogy-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "genealogy-mcp": {
      "command": "uvx",
      "args": [
        "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-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "genealogy-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "genealogy-mcp": {
      "command": "uvx",
      "args": [
        "genealogy-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "genealogy-mcp": {
      "command": "uvx",
      "args": [
        "genealogy-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (7)

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

check_match
Compares a find with a person fact by fact
kinship
Names a relationship in three languages with expected DNA share
audit_tree
Finds impossible dates and possible duplicates in a tree
cyrillic_numerals
Reads Church Slavonic numerals
feast_date
Converts a church-feast date
dna_match
Suggests relationships from shared cM
where_are_records
Says which archive holds a province's records today

What it does

Archive guides
179 sources by country, period and record type with search advice.
Name variants
Spelling, transliteration and given-name equivalents.
Calendar tools
Julian, Hebrew, French Republican and church-feast dates.
Match checking
Compares facts and labels finds confirmed or probable.
GEDCOM editing
Edits your tree in place, showing changes first.
Research project memory
Stores sources, leads and every search, including empty ones.

Good for

  • Plan where to look for an ancestor born in a given province
  • Decide whether a baptism record is the same person
  • Audit a GEDCOM tree for impossible dates and duplicates
  • Convert a feast-day date to a calendar date
  • Draft a records request to an archive

Pricing

Open source

Free PyPI package

Genealogy research toolkit FAQ

Does it run in the cloud?

No, it runs on your computer and goes online only for searches you request.

How do I install it?

Claude Code: claude mcp add genealogy -- uvx genealogy-mcp. Claude Desktop can use a downloadable .mcpb bundle.

Will it change my tree without asking?

It shows each change first, rewrites only the changed lines and keeps a copy of the file.

Is Genealogy research toolkit free?

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

How do I add Genealogy research toolkit to Claude Code?

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

What are the best alternatives to Genealogy research toolkit?

The closest alternatives to Genealogy research toolkit 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.

How AIPoweredBot checks servers