Gramps Web MCP

Package (oci)

docker run -i --rm ghcr.io/scormave/gramps-web-mcp:1.0.8

Or add to your MCP client config:

{
  "mcpServers": {
    "gramps-web-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/scormave/gramps-web-mcp:1.0.8"
      ],
      "env": {
        "MCP_TRANSPORT": "<YOUR_VALUE>",
        "GRAMPS_API_URL": "<YOUR_VALUE>",
        "GRAMPS_USERNAME": "<YOUR_VALUE>",
        "GRAMPS_PASSWORD": "<YOUR_VALUE>",
        "GRAMPS_TREE_ID": "<YOUR_VALUE>",
        "GRAMPS_READ_ONLY": "<YOUR_VALUE>",
        "GRAMPS_MUTATION_SERIALIZE": "<YOUR_VALUE>",
        "GRAMPS_MUTATION_MIN_INTERVAL_MS": "<YOUR_VALUE>"
      }
    }
  }
}

• 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 required — Gramps Web API username
• GRAMPS_PASSWORD required secret — Gramps Web API password or token
• 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