Gramps Web MCP

stdio

MCP server for structured access to Gramps Web genealogy data

Getting Started

npx @getmcp/cli add io.github.Scormave/gramps-web-mcp

Requires Docker Engine. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

GRAMPS_API_URL
Base URL of your Gramps Web instance
GRAMPS_USERNAME
Gramps Web API username
GRAMPS_PASSWORD
Gramps Web API password or token
GRAMPS_TREE_ID
Gramps Web tree UUID

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.Scormave/gramps-web-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "GRAMPS_API_URL",
        "-e",
        "GRAMPS_USERNAME",
        "-e",
        "GRAMPS_PASSWORD",
        "-e",
        "GRAMPS_TREE_ID",
        "-e",
        "GRAMPS_READ_ONLY",
        "ghcr.io/scormave/gramps-web-mcp:1.0.1"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "GRAMPS_API_URL": "",
        "GRAMPS_USERNAME": "",
        "GRAMPS_PASSWORD": "",
        "GRAMPS_TREE_ID": "",
        "GRAMPS_READ_ONLY": "false"
      }
    }
  }
}

Claude Desktop MCP documentation