How do I install Gramps Web MCP?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Gramps Web MCP need an API key?

The publisher lists these environment variables: MCP_TRANSPORT, GRAMPS_API_URL, GRAMPS_USERNAME, GRAMPS_PASSWORD, GRAMPS_REFRESH_TOKEN, GRAMPS_TREE_ID, GRAMPS_READ_ONLY, GRAMPS_MUTATION_SERIALIZE, GRAMPS_MUTATION_MIN_INTERVAL_MS, GRAMPS_LOG_LEVEL, GRAMPS_MEDIA_RESOURCES_ENABLED, GRAMPS_MEDIA_MAX_BYTES, GRAMPS_MEDIA_ALLOW_PRIVATE.

What transport does Gramps Web MCP use?

Gramps Web MCP runs locally over stdio.

When was Gramps Web MCP last checked?

Last checked 2026-10-16. MCP server for structured access to Gramps Web genealogy data

Gramps Web MCP

by io.github.Scormave

MCP server for structured access to Gramps Web genealogy data

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command

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

Credentials from the publisher

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 — 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 — Gramps Web API password; required with GRAMPS_USERNAME unless GRAMPS_REFRESH_TOKEN is set
GRAMPS_REFRESH_TOKEN — Refresh token for instances with password login disabled; replaces GRAMPS_USERNAME and GRAMPS_PASSWORD
GRAMPS_TREE_ID — 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_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
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

Provider

Claude Code

MCP_TRANSPORT=<value> GRAMPS_API_URL=<value> GRAMPS_USERNAME=<value> GRAMPS_PASSWORD=<secret> GRAMPS_REFRESH_TOKEN=<secret> GRAMPS_TREE_ID=<value> GRAMPS_READ_ONLY=<value> GRAMPS_MUTATION_SERIALIZE=<value> GRAMPS_MUTATION_MIN_INTERVAL_MS=<value> GRAMPS_LOG_LEVEL=<value> GRAMPS_MEDIA_RESOURCES_ENABLED=<value> GRAMPS_MEDIA_MAX_BYTES=<value> GRAMPS_MEDIA_ALLOW_PRIVATE=<value> claude mcp add io.github.scormave-gramps-web-mcp -- docker run -i --rm ghcr.io/scormave/gramps-web-mcp:2.4.0

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.scormave-gramps-web-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/scormave/gramps-web-mcp:2.4.0"
      ],
      "env": {
        "MCP_TRANSPORT": "<value>",
        "GRAMPS_API_URL": "<value>",
        "GRAMPS_USERNAME": "<value>",
        "GRAMPS_PASSWORD": "<secret>",
        "GRAMPS_REFRESH_TOKEN": "<secret>",
        "GRAMPS_TREE_ID": "<value>",
        "GRAMPS_READ_ONLY": "<value>",
        "GRAMPS_MUTATION_SERIALIZE": "<value>",
        "GRAMPS_MUTATION_MIN_INTERVAL_MS": "<value>",
        "GRAMPS_LOG_LEVEL": "<value>",
        "GRAMPS_MEDIA_RESOURCES_ENABLED": "<value>",
        "GRAMPS_MEDIA_MAX_BYTES": "<value>",
        "GRAMPS_MEDIA_ALLOW_PRIVATE": "<value>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all