Gramps Web MCP

io.github.Scormave/gramps-web-mcp

MCP server for structured access to Gramps Web genealogy data

View repository →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "gramps-web-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/scormave/gramps-web-mcp:2.9.1"
      ],
      "env": {
        "GRAMPS_API_URL": "<your GRAMPS_API_URL>",
        "GRAMPS_PASSWORD": "<your GRAMPS_PASSWORD>",
        "GRAMPS_REFRESH_TOKEN": "<your GRAMPS_REFRESH_TOKEN>",
        "GRAMPS_TREE_ID": "<your GRAMPS_TREE_ID>",
        "GRAMPS_READ_ONLY": "false",
        "GRAMPS_MUTATION_SERIALIZE": "true",
        "GRAMPS_MUTATION_MIN_INTERVAL_MS": "0",
        "GRAMPS_CONFIRMATION": "when-supported",
        "GRAMPS_LOG_LEVEL": "Information",
        "GRAMPS_MEDIA_RESOURCES_ENABLED": "false",
        "GRAMPS_MEDIA_MAX_BYTES": "5242880",
        "GRAMPS_MEDIA_ALLOW_PRIVATE": "false",
        "GRAMPS_MEDIA_UPLOAD_MAX_BYTES": "52428800"
      }
    }
  }
}
Environment variables
  • GRAMPS_API_URLrequiredBase URL of your Gramps Web instance
  • GRAMPS_PASSWORDsecretGramps Web API password; required with GRAMPS_USERNAME unless GRAMPS_REFRESH_TOKEN is set
  • GRAMPS_REFRESH_TOKENsecretRefresh token for instances with password login disabled; replaces GRAMPS_USERNAME and GRAMPS_PASSWORD
  • GRAMPS_TREE_IDrequiredGramps Web tree UUID
  • GRAMPS_READ_ONLYSet to true to block create, update, and delete tools
  • GRAMPS_MUTATION_SERIALIZESerialize create/update/delete HTTP calls in-process (set false to allow parallel writes)
  • GRAMPS_MUTATION_MIN_INTERVAL_MSMinimum milliseconds between mutation HTTP calls. Use 250 or 500 on SQLite if you see database is locked
  • GRAMPS_CONFIRMATIONWhether 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_LEVELServer 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_ENABLEDSet 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_BYTESMaximum bytes returned by read_media or a media resource
  • GRAMPS_MEDIA_ALLOW_PRIVATESet to true to return bytes for media records marked private
  • GRAMPS_MEDIA_UPLOAD_MAX_BYTESLargest file create_media or update_media uploads

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
2.9.1
Registry
active
Published
11/3/2026

More Developer Tools servers

Browse all Developer Tools →

AgentBooks

scott2121

Marketplace where AI agents buy and sell books — curated domain knowledge that improves tasks.

Developer ToolsAdded 5 months ago

bookstore4agents

scott2121

Marketplace where AI agents buy and sell books — curated domain knowledge that improves tasks.

Developer ToolsAdded 5 months ago

io.github.scottchronicity/ephemeris-mcp

scottchronicity

Precision astronomical ephemeris and planetary positions via the Swiss Ephemeris.

Developer ToolsAdded 7 months ago

sncro

scottconfusedgorilla

Live browser debugging for AI assistants — DOM, console, network via MCP.

Developer ToolsAdded 6 months ago

io.github.scottmreed/ChemCP

scottmreed

MCP App that renders 2D molecular structures from SMILES using RDKit.js

Developer ToolsAdded 9 months ago

io.github.Scottnine/filamental

Scottnine

Search, read and build your Filamental knowledge graph. Local-first: notes stay on your computer.

Developer ToolsAdded 1 week ago

Add the badge to your site

Show visitors that Gramps Web MCP is listed here — it’s also the link we check for a free listing.

Gramps Web MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-scormave-gramps-web-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Gramps Web MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Gramps Web MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-scormave-gramps-web-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.