Gramps Web Mcp

MCP server for structured access to Gramps Web genealogy data

LLM Mart 0 views 87 listing impressions

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 in VS Code][install-vscode] [Install in VS Code Insiders][install-vscode-insiders] [Add to Cursor][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 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
  • History and undo — get_recent_changes shows the edit history, or who changed each field of one record and what it held before; undo_change reverts one transaction. 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.

From the project's README.