Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

Gramps Web MCP

by Scormaveversion 2.9.1i★ –iRuns on your computer
Registry nameio.github.Scormave/gramps-web-mcp

Install

Overview

Description from the maker (original English)

MCP server for structured access to Gramps Web genealogy data

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs on your computer
  • Transport: stdio
  • Category: Other
  • You need to fill in: GRAMPS_API_URL, GRAMPS_PASSWORD, GRAMPS_REFRESH_TOKEN, GRAMPS_TREE_ID

Install

Pick the AI app you use, then copy the settings.

Before you install

  • Basic checks: 1 of 1 passed
  • Runs on your computer with your user’s permissions (files, network, apps).
  • You fill in yourself: 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_CONFIRMATION, GRAMPS_LOG_LEVEL, GRAMPS_MEDIA_RESOURCES_ENABLED, GRAMPS_MEDIA_MAX_BYTES, GRAMPS_MEDIA_ALLOW_PRIVATE, GRAMPS_MEDIA_UPLOAD_DIRS, GRAMPS_MEDIA_UPLOAD_MAX_BYTES

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "gramps-web": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "GRAMPS_API_URL",
        "-e",
        "GRAMPS_USERNAME",
        "-e",
        "GRAMPS_PASSWORD",
        "-e",
        "GRAMPS_REFRESH_TOKEN",
        "-e",
        "GRAMPS_TREE_ID",
        "-e",
        "GRAMPS_READ_ONLY",
        "-e",
        "GRAMPS_MUTATION_SERIALIZE",
        "-e",
        "GRAMPS_MUTATION_MIN_INTERVAL_MS",
        "-e",
        "GRAMPS_CONFIRMATION",
        "-e",
        "GRAMPS_LOG_LEVEL",
        "-e",
        "GRAMPS_MEDIA_RESOURCES_ENABLED",
        "-e",
        "GRAMPS_MEDIA_MAX_BYTES",
        "-e",
        "GRAMPS_MEDIA_ALLOW_PRIVATE",
        "-e",
        "GRAMPS_MEDIA_UPLOAD_DIRS",
        "-e",
        "GRAMPS_MEDIA_UPLOAD_MAX_BYTES",
        "ghcr.io/scormave/gramps-web-mcp:2.9.1"
      ],
      "env": {
        "MCP_TRANSPORT": "your-value",
        "GRAMPS_API_URL": "your-value",
        "GRAMPS_USERNAME": "your-value",
        "GRAMPS_PASSWORD": "your-value",
        "GRAMPS_REFRESH_TOKEN": "your-value",
        "GRAMPS_TREE_ID": "your-value",
        "GRAMPS_READ_ONLY": "your-value",
        "GRAMPS_MUTATION_SERIALIZE": "your-value",
        "GRAMPS_MUTATION_MIN_INTERVAL_MS": "your-value",
        "GRAMPS_CONFIRMATION": "your-value",
        "GRAMPS_LOG_LEVEL": "your-value",
        "GRAMPS_MEDIA_RESOURCES_ENABLED": "your-value",
        "GRAMPS_MEDIA_MAX_BYTES": "your-value",
        "GRAMPS_MEDIA_ALLOW_PRIVATE": "your-value",
        "GRAMPS_MEDIA_UPLOAD_DIRS": "your-value",
        "GRAMPS_MEDIA_UPLOAD_MAX_BYTES": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add gramps-web --env MCP_TRANSPORT=your-value --env GRAMPS_API_URL=your-value --env GRAMPS_USERNAME=your-value --env GRAMPS_PASSWORD=your-value --env GRAMPS_REFRESH_TOKEN=your-value --env GRAMPS_TREE_ID=your-value --env GRAMPS_READ_ONLY=your-value --env GRAMPS_MUTATION_SERIALIZE=your-value --env GRAMPS_MUTATION_MIN_INTERVAL_MS=your-value --env GRAMPS_CONFIRMATION=your-value --env GRAMPS_LOG_LEVEL=your-value --env GRAMPS_MEDIA_RESOURCES_ENABLED=your-value --env GRAMPS_MEDIA_MAX_BYTES=your-value --env GRAMPS_MEDIA_ALLOW_PRIVATE=your-value --env GRAMPS_MEDIA_UPLOAD_DIRS=your-value --env GRAMPS_MEDIA_UPLOAD_MAX_BYTES=your-value -- docker run -i --rm -e MCP_TRANSPORT -e GRAMPS_API_URL -e GRAMPS_USERNAME -e GRAMPS_PASSWORD -e GRAMPS_REFRESH_TOKEN -e GRAMPS_TREE_ID -e GRAMPS_READ_ONLY -e GRAMPS_MUTATION_SERIALIZE -e GRAMPS_MUTATION_MIN_INTERVAL_MS -e GRAMPS_CONFIRMATION -e GRAMPS_LOG_LEVEL -e GRAMPS_MEDIA_RESOURCES_ENABLED -e GRAMPS_MEDIA_MAX_BYTES -e GRAMPS_MEDIA_ALLOW_PRIVATE -e GRAMPS_MEDIA_UPLOAD_DIRS -e GRAMPS_MEDIA_UPLOAD_MAX_BYTES ghcr.io/scormave/gramps-web-mcp:2.9.1

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "gramps-web": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "GRAMPS_API_URL",
        "-e",
        "GRAMPS_USERNAME",
        "-e",
        "GRAMPS_PASSWORD",
        "-e",
        "GRAMPS_REFRESH_TOKEN",
        "-e",
        "GRAMPS_TREE_ID",
        "-e",
        "GRAMPS_READ_ONLY",
        "-e",
        "GRAMPS_MUTATION_SERIALIZE",
        "-e",
        "GRAMPS_MUTATION_MIN_INTERVAL_MS",
        "-e",
        "GRAMPS_CONFIRMATION",
        "-e",
        "GRAMPS_LOG_LEVEL",
        "-e",
        "GRAMPS_MEDIA_RESOURCES_ENABLED",
        "-e",
        "GRAMPS_MEDIA_MAX_BYTES",
        "-e",
        "GRAMPS_MEDIA_ALLOW_PRIVATE",
        "-e",
        "GRAMPS_MEDIA_UPLOAD_DIRS",
        "-e",
        "GRAMPS_MEDIA_UPLOAD_MAX_BYTES",
        "ghcr.io/scormave/gramps-web-mcp:2.9.1"
      ],
      "env": {
        "MCP_TRANSPORT": "your-value",
        "GRAMPS_API_URL": "your-value",
        "GRAMPS_USERNAME": "your-value",
        "GRAMPS_PASSWORD": "your-value",
        "GRAMPS_REFRESH_TOKEN": "your-value",
        "GRAMPS_TREE_ID": "your-value",
        "GRAMPS_READ_ONLY": "your-value",
        "GRAMPS_MUTATION_SERIALIZE": "your-value",
        "GRAMPS_MUTATION_MIN_INTERVAL_MS": "your-value",
        "GRAMPS_CONFIRMATION": "your-value",
        "GRAMPS_LOG_LEVEL": "your-value",
        "GRAMPS_MEDIA_RESOURCES_ENABLED": "your-value",
        "GRAMPS_MEDIA_MAX_BYTES": "your-value",
        "GRAMPS_MEDIA_ALLOW_PRIVATE": "your-value",
        "GRAMPS_MEDIA_UPLOAD_DIRS": "your-value",
        "GRAMPS_MEDIA_UPLOAD_MAX_BYTES": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "gramps-web": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "GRAMPS_API_URL",
        "-e",
        "GRAMPS_USERNAME",
        "-e",
        "GRAMPS_PASSWORD",
        "-e",
        "GRAMPS_REFRESH_TOKEN",
        "-e",
        "GRAMPS_TREE_ID",
        "-e",
        "GRAMPS_READ_ONLY",
        "-e",
        "GRAMPS_MUTATION_SERIALIZE",
        "-e",
        "GRAMPS_MUTATION_MIN_INTERVAL_MS",
        "-e",
        "GRAMPS_CONFIRMATION",
        "-e",
        "GRAMPS_LOG_LEVEL",
        "-e",
        "GRAMPS_MEDIA_RESOURCES_ENABLED",
        "-e",
        "GRAMPS_MEDIA_MAX_BYTES",
        "-e",
        "GRAMPS_MEDIA_ALLOW_PRIVATE",
        "-e",
        "GRAMPS_MEDIA_UPLOAD_DIRS",
        "-e",
        "GRAMPS_MEDIA_UPLOAD_MAX_BYTES",
        "ghcr.io/scormave/gramps-web-mcp:2.9.1"
      ],
      "env": {
        "MCP_TRANSPORT": "your-value",
        "GRAMPS_API_URL": "your-value",
        "GRAMPS_USERNAME": "your-value",
        "GRAMPS_PASSWORD": "your-value",
        "GRAMPS_REFRESH_TOKEN": "your-value",
        "GRAMPS_TREE_ID": "your-value",
        "GRAMPS_READ_ONLY": "your-value",
        "GRAMPS_MUTATION_SERIALIZE": "your-value",
        "GRAMPS_MUTATION_MIN_INTERVAL_MS": "your-value",
        "GRAMPS_CONFIRMATION": "your-value",
        "GRAMPS_LOG_LEVEL": "your-value",
        "GRAMPS_MEDIA_RESOURCES_ENABLED": "your-value",
        "GRAMPS_MEDIA_MAX_BYTES": "your-value",
        "GRAMPS_MEDIA_ALLOW_PRIVATE": "your-value",
        "GRAMPS_MEDIA_UPLOAD_DIRS": "your-value",
        "GRAMPS_MEDIA_UPLOAD_MAX_BYTES": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

  • MCP_TRANSPORT env
    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 th…
  • GRAMPS_API_URL required env
    Base URL of your Gramps Web instance
  • GRAMPS_USERNAME env
    Gramps Web API username; required with GRAMPS_PASSWORD unless GRAMPS_REFRESH_TOKEN is set
  • GRAMPS_PASSWORD secret env
    Gramps Web API password; required with GRAMPS_USERNAME unless GRAMPS_REFRESH_TOKEN is set
  • GRAMPS_REFRESH_TOKEN secret env
    Refresh token for instances with password login disabled; replaces GRAMPS_USERNAME and GRAMPS_PASSWORD
  • GRAMPS_TREE_ID required env
    Gramps Web tree UUID
  • GRAMPS_READ_ONLY env
    Set to true to block create, update, and delete tools
  • GRAMPS_MUTATION_SERIALIZE env
    Serialize create/update/delete HTTP calls in-process (set false to allow parallel writes)
  • GRAMPS_MUTATION_MIN_INTERVAL_MS env
    Minimum milliseconds between mutation HTTP calls. Use 250 or 500 on SQLite if you see database is locked
  • GRAMPS_CONFIRMATION env
    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 env
    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 env
    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 env
    Maximum bytes returned by read_media or a media resource
  • GRAMPS_MEDIA_ALLOW_PRIVATE env
    Set to true to return bytes for media records marked private
  • GRAMPS_MEDIA_UPLOAD_DIRS env
    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…
  • GRAMPS_MEDIA_UPLOAD_MAX_BYTES env
    Largest file create_media or update_media uploads

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account Scormave, which owns the repo

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

  • More stars than 0% of the other 18374 servers in this category
  • Published to the registry more recently than 90% of the other 18374 servers in this category
  • Basic checks equal to or better than 100% of the other 18374 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Gramps Web MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: GRAMPS_API_URL, GRAMPS_PASSWORD, GRAMPS_REFRESH_TOKEN, GRAMPS_TREE_ID

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (2.9.1) reached the registry 4 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Docker on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Happo

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago
Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 2 days ago
Install

Happo

by happo.io

Review Happo's visual and accessibility diffs: inspect comparisons, accept or reject, report flakes.

Runs in the cloudUpdated today
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

gramps-web-mcp

[!WARNING]

Update to 2.3.1 or later. Before 2.3.1 the update_* tools could drop

stored data that the call did not mention

(#5). If you edited a

tree with an earlier version,

check it for dropped data.

Companion MCP server for the Gramps Web open-source genealogy platform. It lets AI agents read and edit your family tree through the Model Context Protocol. It is not a genealogy UI: run it alongside an existing Gramps Web instance, where your users, trees, media and permissions stay.

[][install-vscode] [][install-vscode-insiders] [][install-cursor]

The buttons add the server to VS Code or Cursor, which start it from the Docker image, so Docker must be installed. For Claude Desktop, install the MCPB extension; other clients are listed under Install.

Features

  • Up to 35 MCP tools — read, create, update, merge, and delete people, families, events, places, sources, citations, notes, media, repositories, and tags
  • Search and kinship — full-text search, listings filtered by Gramps QL or Gramps filter rules, ancestors, descendants, relationships, and timelines
  • Careful edits — add or remove one link with linkMode and keep the rest; save a whole register entry in one transaction with create_records; dates in every Gramps form and calendar
  • Duplicates — find_duplicates pairs people entered twice, across spellings and name forms, and the create tools refuse a person the tree already has
  • Undo and confirmation — undo_change reverts one transaction of the edit history; it, delete_object and merge_objects ask the user, not the model, before they change the tree, in clients that support MCP elicitation
  • Scans and photos — opt-in previews that vision-capable agents can read, with EXIF/GPS metadata stripped, and uploads from a folder you choose
  • 8 MCP resources and guided prompts — type vocabularies, tree metadata, filter rules, and workflows for research, imports, citing facts, and tree audits
  • Read-only mode — publish only read tools and block direct mutation calls
  • Any MCP client — stdio, Streamable HTTP, and legacy SSE, from a Claude Desktop extension, a Docker image, or a single-file release binary

The tool catalog describes every tool, resource and prompt. Upgrading from 1.x? Follow the 2.0 migration guide.

What to ask

Ask in your own words; the agent chooses the tools. The names stand for people in your tree, and a Gramps ID such as I0012 works as well.

You askYou get
"Tell me about Maria García."Her names, events with dates and places, parents, spouses and children, citations and notes
"Who were Kenji Tanaka's great-grandparents?"Each ancestor with a kinship label such as Father's mother, and birth and death dates and places
"How is Ivan Petrov related to Maria García?"The relationship in words, such as second cousin once removed, and the common ancestors by name
"Transcribe the baptism scan O0012."The scan for the agent to read, and the transcription in its reply
"Add Thomas Weber, born 3 May 1881 in Hamburg, son of Karl and Anna Weber."The new records with their Gramps IDs, people already in the tree reused, and what the text left open
"Enter entry 12 of the 1884 marriage register: the couple, their fathers and the witnesses."The citation, the marriage, the new people and families saved in one transaction, which one undo_change takes back
"What changed today? Undo the last edit."The edit history, then the earlier versions back, or a refusal naming the later edits the undo would overwrite

Reading scans needs media access. The tool catalog lists more requests and the tools each one uses.

Install

You need a running Gramps Web instance and an account on it. Choose the setup by client:

ClientSetup
Claude DesktopThe MCPB extension, installed from one file; no Docker
VS Code, CursorThe install buttons above; the client starts the Docker image
Claude Code, Codex, Gemini CLI, Antigravity CLI, Open WebUI and othersConnecting MCP clients: over HTTP to a shared server, or started by the client from the Docker image or the release binary
Several clients or machinesOne server in Docker, Docker Compose or on Unraid, reached over HTTP
Claude Desktop
  1. Download the .mcpb bundle for your platform from the latest release, such as gramps-web-mcp-claude-desktop-osx-arm64-v*.mcpb for Apple Silicon.
  2. Double-click it, or drag it into the Claude Desktop window.
  3. Enter your Gramps Web URL, username, password/token, and tree UUID.
  4. Leave Read-only mode enabled for your first session; disable it only when you want Claude to create or edit records.
  5. Complete installation and start a new chat.

Claude Desktop connects to servers added by URL from Anthropic's cloud, not from your computer, so it cannot reach a server on your home network; use the extension there. Installation lists the bundle for each platform.

Docker

For one server that several clients share:

docker run -p 8080:8080 \

-e GRAMPS_API_URL=https://your-gramps.example.com \ -e GRAMPS_USERNAME=your-user \ -e GRAMPS_PASSWORD=your-password \ -e GRAMPS_TREE_ID=your-tree-uuid \ -e MCP_API_KEY=your-secret-api-key \ ghcr.io/scormave/gramps-web-mcp:latest

Clients then connect to http:// :8080/mcp with the API key, as shown in Over HTTP. Add -e GRAMPS_READ_ONLY=true for read-only mode. Installation covers refresh tokens, health checks, image verification, Docker Compose with Gramps Web, Unraid and upgrades.

Configuration

Every setting is an environment variable. The main ones:

VariableDescriptionDefault
GRAMPS_API_URLBase URL of your Gramps Web instance (no trailing slash)—
GRAMPS_USERNAME, GRAMPS_PASSWORDThe Gramps Web account the server works as—
GRAMPS_REFRESH_TOKENUsed instead of the user name and password when Gramps Web has password login turned off—
GRAMPS_TREE_IDTree UUID on that server—
GRAMPS_READ_ONLYtrue publishes only read tools and blocks writesfalse (the Claude Desktop extension: true)
GRAMPS_MEDIA_RESOURCES_ENABLEDLets agents read scans and photos, and enables uploadsfalse
GRAMPS_MEDIA_UPLOAD_DIRSFolders that create_media may upload fromunset (off)
MCP_TRANSPORTstdio, http (Streamable HTTP) or ssestdio (the Docker image: http)
MCP_API_KEYKey that HTTP clients must send; set it whenever other machines can reach the port—

Configuration describes every setting, including write pacing for SQLite, confirmation dialogs, media limits, transports, browser origins and logging.

Documentation

DocumentDescription
InstallationClaude Desktop, Docker, Docker Compose, Unraid, health checks, and upgrades
Connecting MCP clientsClaude Code, VS Code, Cursor, Codex, Gemini and Antigravity CLI, and Open WebUI, over HTTP or stdio
ConfigurationEvery environment variable
Tool catalogEvery tool, resource and prompt, and more example requests
System promptSuggested prompt for MCP clients
Migrating to 2.0Tool replacements and setup changes for 1.x users
Claude Desktop MCPBDesktop extension packaging
ArchitectureSystem design overview
Developer guideRunning from source, tests, and adding tools
docs indexAll documentation files

Contributing

Contributions are welcome. ./run-local-server.sh runs the server from source against the public demo.grampsweb.org tree at http://127.0.0.1:8080/mcp, and dotnet test runs the tests. See CONTRIBUTING.md and the developer guide.

Sponsors

gramps-web-mcp is free and open source. If it helps your research, you can support its development through GitHub Sponsors, monthly or once. Sponsors whose tier includes a mention are listed here.

Security

To report a vulnerability, see SECURITY.md.

Privacy Policy

The Claude Desktop extension is a local MCP server. It sends data only to the Gramps Web instance you configure and does not collect analytics or conversation data. See PRIVACY.md for full details.

License

Copyright (c) Scormave

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-or-later). Because this is network server software, hosting a modified version requires making the corresponding source available to users interacting with it over a network.

Bundled third-party components, such as ImageSharp, the MCP C# SDK, and the .NET runtime, keep their own Apache 2.0 or MIT licenses; see THIRD-PARTY-NOTICES.txt. The MCP Bundles and the Docker image ship that file next to LICENSE.

Only the beginning is shown; read the rest in the repo

Ask PopNx