Skip to main content
Glama
Genealogy-MCP

gedcom-mcp

gedcom-mcp

MCP server for querying local GEDCOM genealogy files through AI assistants. Load any .ged file and search, browse, and traverse your family tree without leaving your AI workflow.

Part of the Genealogy-MCP organization.

Note: GitHub is a read-only mirror. Development happens on GitLab.

Available Tools

Tool

Description

load_file

Load and parse a GEDCOM (.ged) file into memory

search_persons

Search individuals by name, dates, place, sex

get_person

Retrieve a specific individual by cross-reference ID

get_family

Retrieve a family record (accepts family or individual xref)

get_ancestors

Get the ancestor tree for an individual

get_descendants

Get the descendant tree for an individual

get_stats

Get statistics about the loaded GEDCOM file

Related MCP server: GEDCOM MCP Server

Configuration

All settings are optional with sensible defaults.

Environment Variable

Default

Description

GEDCOM_MAX_FILE_SIZE_MB

100

Maximum allowed GEDCOM file size in MB

GEDCOM_DEFAULT_ANCESTOR_DEPTH

5

Default ancestor traversal depth

GEDCOM_DEFAULT_DESCENDANT_DEPTH

5

Default descendant traversal depth

GEDCOM_MAX_TREE_DEPTH

50

Hard ceiling on traversal depth

GEDCOM_MAX_SEARCH_RESULTS

100

Maximum search results returned

GEDCOM_ALLOWED_BASE_DIRS

(empty)

Comma-separated allowed directories for file loading

Setup: Claude Desktop

Add to your claude_desktop_config.json:

Using uv (local)

{
  "mcpServers": {
    "gedcom": {
      "command": "uv",
      "args": ["--directory", "/path/to/gedcom-mcp", "run", "gedcom-mcp"],
      "env": {
        "GEDCOM_ALLOWED_BASE_DIRS": "/path/to/your/gedcom/files"
      }
    }
  }
}

Using Docker

{
  "mcpServers": {
    "gedcom": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/path/to/your/gedcom/files:/data:ro",
        "-e", "GEDCOM_ALLOWED_BASE_DIRS=/data",
        "ghcr.io/genealogy-mcp/gedcom-mcp"
      ]
    }
  }
}

Setup: Claude Code

Using uv (local)

claude mcp add gedcom -- uv --directory /path/to/gedcom-mcp run gedcom-mcp

Using Docker

claude mcp add gedcom -- docker run -i --rm \
  -v /path/to/your/gedcom/files:/data:ro \
  -e GEDCOM_ALLOWED_BASE_DIRS=/data \
  ghcr.io/genealogy-mcp/gedcom-mcp

Development

# Install dependencies
make install

# Run tests with coverage
make test

# Run all checks (lint + type-check + test + audit)
make ci

# Format code
make format

# Run via stdio transport
make run-stdio

# Run via streamable-http on port 8000
make run

License

AGPL-3.0-only

Install Server
A
license - permissive license
A
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    B
    maintenance
    Enables AI agents to create, edit, and query genealogical data from GEDCOM files. Supports complex genealogy searches, automatic data enrichment from web sources, relationship analysis, and biography generation for individuals and families.
    Last updated
    13
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Enables AI assistants to interact with Gramps genealogy databases for intelligent family tree research and management. Provides comprehensive tools for searching family data, creating records, analyzing relationships, and tracking genealogy research through natural language.
    Last updated
    39
    AGPL 3.0

View all related MCP servers

Related MCP Connectors

  • Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.

  • Read-only A2Me family context tools for AI assistants (members, dates, activity, relationships)

  • Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Genealogy-MCP/gedcom-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server