Gramps Web Mcp
MCP server for structured access to Gramps Web genealogy data
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 field values or Gramps filter rules, ancestors, descendants, relationships, and timelines
- Careful edits — add or remove one link with
linkModeand keep the rest; save a whole register entry in one transaction withcreate_records; dates in every Gramps form and calendar - Duplicates —
find_duplicatespairs people entered twice, across spellings and name forms, and the create tools refuse a person the tree already has - History and undo —
get_recent_changesshows the edit history, or who changed each field of one record and what it held before;undo_changereverts one transaction. It,delete_objectandmerge_objectsask 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.
From the project's README.