Gramps Web MCP

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-10-16T09:21:40.195797Z",
      "publishedAt": "2026-10-16T09:21:40.195797Z",
      "statusChangedAt": "2026-10-16T09:21:40.195797Z"
    }
  },
  "server": {
    "name": "io.github.Scormave/gramps-web-mcp",
    "title": "Gramps Web MCP",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "2.6.0",
    "packages": [
      {
        "transport": {
          "type": "stdio"
        },
        "identifier": "ghcr.io/scormave/gramps-web-mcp:2.6.0",
        "runtimeHint": "docker",
        "registryType": "oci",
        "environmentVariables": [
          {
            "name": "MCP_TRANSPORT",
            "value": "stdio",
            "description": "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."
          },
          {
            "name": "GRAMPS_API_URL",
            "isRequired": true,
            "description": "Base URL of your Gramps Web instance"
          },
          {
            "name": "GRAMPS_USERNAME",
            "description": "Gramps Web API username; required with GRAMPS_PASSWORD unless GRAMPS_REFRESH_TOKEN is set"
          },
          {
            "name": "GRAMPS_PASSWORD",
            "isSecret": true,
            "description": "Gramps Web API password; required with GRAMPS_USERNAME unless GRAMPS_REFRESH_TOKEN is set"
          },
          {
            "name": "GRAMPS_REFRESH_TOKEN",
            "isSecret": true,
            "description": "Refresh token for instances with password login disabled; replaces GRAMPS_USERNAME and GRAMPS_PASSWORD"
          },
          {
            "name": "GRAMPS_TREE_ID",
            "isRequired": true,
            "description": "Gramps Web tree UUID"
          },
          {
            "name": "GRAMPS_READ_ONLY",
            "default": "false",
            "description": "Set to true to block create, update, and delete tools"
          },
          {
            "name": "GRAMPS_MUTATION_SERIALIZE",
            "default": "true",
            "description": "Serialize create/update/delete HTTP calls in-process (set false to allow parallel writes)"
          },
          {
            "name": "GRAMPS_MUTATION_MIN_INTERVAL_MS",
            "default": "0",
            "description": "Minimum milliseconds between mutation HTTP calls. Use 250 or 500 on SQLite if you see database is locked"
          },
          {
            "name": "GRAMPS_LOG_LEVEL",
            "default": "Information",
            "description": "Server log level: Trace, Debug, Information, Warning, Error, Critical, or None. Debug and Trace also log request and response bodies, which contain genealogy data"
          },
          {
            "name": "GRAMPS_MEDIA_RESOURCES_ENABLED",
            "default": "false",
            "description": "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"
          },
          {
            "name": "GRAMPS_MEDIA_MAX_BYTES",
            "default": "5242880",
            "description": "Maximum bytes returned by read_media or a media resource"
          },
          {
            "name": "GRAMPS_MEDIA_ALLOW_PRIVATE",
            "default": "false",
            "description": "Set to true to return bytes for media records marked private"
          },
          {
            "name": "GRAMPS_MEDIA_UPLOAD_DIRS",
            "description": "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"
          },
          {
            "name": "GRAMPS_MEDIA_UPLOAD_MAX_BYTES",
            "default": "52428800",
            "description": "Largest file create_media or update_media uploads"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/Scormave/gramps-web-mcp",
      "source": "github"
    },
    "description": "MCP server for structured access to Gramps Web genealogy data"
  }
}