playbooks

home / mcp / gedcom mcp server

GEDCOM MCP Server

MCP Server to create or query GEDCOM files

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "airy10-gedcommcp": {
      "command": "python",
      "args": [
        "src/gedcom_mcp/fastmcp_server.py"
      ]
    }
  }
}

GEDCOM MCP Server lets you load, edit, and query genealogical data from GEDCOM files using a flexible MCP interface. It enables powerful research, data analysis, and automated genealogy storytelling by AI agents, while maintaining backward compatibility with existing GEDCOM data and workflows.

How to use

You interact with the GEDCOM MCP Server by running it locally or connecting through an MCP client. Start with a simple HTTP transport to accept requests from your client, then use the server to load GEDCOM files, search individuals and families, generate family trees, timelines, and reports, or perform batch operations. The server supports data loading, editing, querying, and rich metadata handling for notes, sources, and events.

How to install

# Prerequisites: ensure Python and pip are installed on your system

# 1) Clone the project
git clone https://github.com/airy10/GedcomMCP.git
cd GedcomMCP

# 2) Install dependencies
pip install -r requirements.txt

Additional sections

Configuration notes: The server can be started for HTTP transport by running the main server script with Python. You can also run it in stdio mode for local development workflows. Start with the default HTTP transport, or switch to stdio to interact directly from your terminal.

Examples of common startup commands: - Start the server with the default HTTP transport: python src/gedcom_mcp/fastmcp_server.py - Start the server with stdio transport: python src/gedcom_mcp/fastmcp_server.py --transport stdio - Expose the server on a specific host and port for HTTP transport: python src/gedcom_mcp/fastmcp_server.py --host 0.0.0.0 --port 8080

Available tools

Load GEDCOM

Load GEDCOM files into the MCP server for processing and analysis.

Query data

Search across individuals, families, events, and places using flexible criteria.

Generate trees

Create multi-generational ancestor and descendant trees with detailed information.

Create timelines

Generate chronological timelines of life events for individuals or families.