Scormave

gramps-web-mcp is an MCP (Model Context Protocol) server that connects AI clients to your Gramps Web family tree. Install it from the Unraid Apps catalog: search for gramps-web-mcp → Install. It is not a genealogy web UI on its own. You need a separate running Gramps Web instance with API access. This container exposes MCP over HTTP so tools like Cursor, Claude Desktop, Open WebUI, and other MCP-capable clients can search, read, and optionally update your tree data. Links- Project: https://github.com/Scormave/gramps-web-mcp - Unraid templates: https://github.com/Scormave/gramps-web-mcp-unraid - Container image: ghcr.io/scormave/gramps-web-mcp:latest - Bug reports / feature requests: https://github.com/Scormave/gramps-web-mcp/issues What it does- 57 MCP tools for people, families, events, places, sources, citations, notes, media, repositories, and tags - Search, kinship queries (ancestors/descendants), timelines, and composite workflows - Optional read-only mode to block create/update/delete while keeping tools visible - Optional media access with size limits, MIME allowlists, and private-record safeguards - HTTP MCP endpoint at /mcp (Streamable HTTP) - Health check at /health (HTTP 200 when Gramps Web auth works, 503 otherwise) Prerequisites- A running Gramps Web instance - Gramps Web API username and password (or token) - Tree UUID from your Gramps Web server - Network path from the container to Gramps Web — use a LAN IP or hostname the container can reach, not localhost if Gramps runs in another container or on another host Installation1. Go to Apps 2. Search for gramps-web-mcp 3. Click Install 4. Fill in the required variables and click Apply Required configuration- GRAMPS_API_URL — base URL of Gramps Web, no trailing slash (example: https://192.168.1.50:5000) - GRAMPS_USERNAME — API user - GRAMPS_PASSWORD — API password or token - GRAMPS_TREE_ID — tree UUID - MCP HTTP Port — default 8080 (maps host port → container 8080) Optional settings- GRAMPS_READ_ONLY — set to true to block mutations - GRAMPS_MEDIA_RESOURCES_ENABLED — enable media thumbnails/files for vision-capable agents (off by default) - Other media limits are under Advanced View in the template Usage after installPoint your MCP client at: http://[your-unraid-ip]:8080/mcp Quick connectivity check from another machine on your LAN: curl -i http://[your-unraid-ip]:8080/health You should get HTTP 200 when Gramps credentials and tree ID are correct and Gramps Web is reachable. There is no browser web UI for this container — it is an API/MCP service only. TroubleshootingContainer exits immediately Check Docker logs. Usually a missing or empty required variable: GRAMPS_API_URL, GRAMPS_USERNAME, GRAMPS_PASSWORD, or GRAMPS_TREE_ID. Health check returns 503 The MCP server is running but cannot authenticate to Gramps Web. Verify URL, credentials, tree UUID, and that the container can reach Gramps Web over the network. Image pull fails The GHCR package must be public: ghcr.io/scormave/gramps-web-mcp Cannot reach Gramps Web If Gramps Web runs in another Docker container on Unraid, use that container's IP or a Docker network hostname — not 127.0.0.1 or localhost from inside this container. Reporting issues- MCP server / container bugs: https://github.com/Scormave/gramps-web-mcp/issues - Unraid template issues: https://github.com/Scormave/gramps-web-mcp-unraid/issues - Questions about this Unraid install: reply in this thread License noteThe container image is licensed under AGPL-3.0. If you run or redistribute a modified version, AGPL source-offer obligations may apply. Feedback and install reports are welcome in this thread.