Gramps Web MCP

Package (oci)

docker run -i --rm -e GRAMPS_API_URL=<YOUR_VALUE> -e GRAMPS_PASSWORD=<YOUR_VALUE> -e GRAMPS_REFRESH_TOKEN=<YOUR_VALUE> -e GRAMPS_TREE_ID=<YOUR_VALUE> ghcr.io/scormave/gramps-web-mcp:2.10.0

Or add to your MCP client config:

{
  "mcpServers": {
    "gramps-web-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GRAMPS_API_URL=<YOUR_VALUE>",
        "-e",
        "GRAMPS_PASSWORD=<YOUR_VALUE>",
        "-e",
        "GRAMPS_REFRESH_TOKEN=<YOUR_VALUE>",
        "-e",
        "GRAMPS_TREE_ID=<YOUR_VALUE>",
        "ghcr.io/scormave/gramps-web-mcp:2.10.0"
      ]
    }
  }
}

• MCP_TRANSPORT — Pinned to stdio for registry-installed containers that the client spawns itself. The image's own default is http (Streamable HTTP on port 8080) for networked Docker deployments; see the README for that setup.
• GRAMPS_API_URL required — Base URL of your Gramps Web instance
• GRAMPS_USERNAME — Gramps Web API username; required with GRAMPS_PASSWORD unless GRAMPS_REFRESH_TOKEN is set
• GRAMPS_PASSWORD secret — Gramps Web API password; required with GRAMPS_USERNAME unless GRAMPS_REFRESH_TOKEN is set
• GRAMPS_REFRESH_TOKEN secret — Refresh token for instances with password login disabled; replaces GRAMPS_USERNAME and GRAMPS_PASSWORD
• GRAMPS_TREE_ID required — Gramps Web tree UUID
• GRAMPS_READ_ONLY — Set to true to block create, update, and delete tools
• GRAMPS_MUTATION_SERIALIZE — Serialize create/update/delete HTTP calls in-process (set false to allow parallel writes)
• GRAMPS_MUTATION_MIN_INTERVAL_MS — Minimum milliseconds between mutation HTTP calls. Use 250 or 500 on SQLite if you see database is locked
• GRAMPS_CONFIRMATION — Whether delete_object, merge_objects and undo_change ask the user to confirm through MCP elicitation: when-supported, required (refuse in clients that cannot ask), or off
• GRAMPS_LOG_LEVEL — Server log level: Trace, Debug, Information, Warning, Error, Critical, or None. Debug and Trace also log request and response bodies, which contain genealogy data
• GRAMPS_MEDIA_RESOURCES_ENABLED — Set to true to expose read_media and the media resources for thumbnails and full files, and to allow uploads from GRAMPS_MEDIA_UPLOAD_DIRS
• GRAMPS_MEDIA_MAX_BYTES — Maximum bytes returned by read_media or a media resource
• GRAMPS_MEDIA_ALLOW_PRIVATE — Set to true to return bytes for media records marked private
• GRAMPS_MEDIA_UPLOAD_DIRS — Absolute folders, separated by : (; on Windows), that create_media and update_media may upload photos, scans and PDFs from while GRAMPS_MEDIA_RESOURCES_ENABLED is true. Unset turns uploading off and hides create_media
• GRAMPS_MEDIA_UPLOAD_MAX_BYTES — Largest file create_media or update_media uploads