Gramps MCP MCP Server

Official registry Search and web

MCP server for Gramps genealogy via the Gramps Web API: CRUD, search, merge, timelines, DNA.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http gramps-mcp-mcp-server 'https://ghcr.io/oliverhruby/gramps-mcp:latest'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "gramps-mcp-mcp-server": {
            "type": "http",
            "url": "https://ghcr.io/oliverhruby/gramps-mcp:latest"
        }
    }
}
PYPI package gramps-mcp-full
Claude Code
claude mcp add gramps-mcp-mcp-server -e 'GRAMPS_MCP_USERNAME=<your gramps_mcp_username>' -e 'GRAMPS_MCP_PASSWORD=<your gramps_mcp_password>' -e 'GRAMPS_MCP_INSTANCES=<GRAMPS_MCP_INSTANCES>' -- uvx gramps-mcp-full==0.2.1
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "gramps-mcp-mcp-server": {
            "command": "uvx",
            "args": [
                "gramps-mcp-full==0.2.1"
            ],
            "env": {
                "GRAMPS_MCP_USERNAME": "<your gramps_mcp_username>",
                "GRAMPS_MCP_PASSWORD": "<your gramps_mcp_password>",
                "GRAMPS_MCP_INSTANCES": "<GRAMPS_MCP_INSTANCES>"
            }
        }
    }
}

Environment variables

  • GRAMPS_MCP_USERNAME required secret Your Gramps MCP username
  • GRAMPS_MCP_PASSWORD required secret Your Gramps MCP password
  • GRAMPS_MCP_INSTANCES Comma-separated account/instance identifiers (optional)

Frequently asked questions

What is Gramps MCP MCP Server?

MCP server for Gramps genealogy via the Gramps Web API: CRUD, search, merge, timelines, DNA.

How do I install Gramps MCP MCP Server?

It runs as a remote server. In Claude Code: claude mcp add --transport http gramps-mcp-mcp-server 'https://ghcr.io/oliverhruby/gramps-mcp:latest'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Gramps MCP MCP Server need an API key?

Yes. It expects GRAMPS_MCP_USERNAME, GRAMPS_MCP_PASSWORD, which you set in its configuration.

Is Gramps MCP MCP Server open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Gramps MCP MCP Server?

It is published by oliverhruby. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.