# Genealogy research toolkit

> Genealogy research toolkit is an open-source MCP server for knowledge and memory. Genealogy MCP server with 179 archive guides, name variants, calendars and tree tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Repository:** https://github.com/igormel81/genealogy-mcp
- **MCP Registry name:** io.github.igormel81/genealogy-mcp
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [books and literature](https://ai-powered.com/categories/books-and-literature)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add genealogy-mcp -- uvx genealogy-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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

## 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.

## 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.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Comicvine](https://ai-powered.com/mcp/comicvine): Comicvine is a freemium MCP server for books and literature.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/genealogy-research-toolkit
