Gramps Web MCP Server

MCP server for structured access to Gramps Web genealogy data

Local serverstdio

What is the Gramps Web MCP Server?

MCP server for structured access to Gramps Web genealogy data

What you get

Companion MCP server for the Gramps Web open-source genealogy platform. It gives AI agents structured, tool-based access to family trees through the Model Context Protocol.

  • 57 MCP tools — — read, create, update, and delete people, families, events, places,
  • Search and browse — — full-text search and paginated object listing
  • Kinship tools — — ancestors, descendants, relationships, and timelines
  • Composite workflows — — quick-add person, add event to person, find by Gramps ID
  • 6 MCP resources — — type vocabularies, input guide, tree metadata, name
  • Media safeguards — — size limits, MIME allowlists, and private-record defaults

Configuration and credentials

  • .NET 8 SDK (for local development) - A running Gramps Web instance with API access - Docker (optional, for container deployment)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
sseLegacy MCP SSE: GET {MCP_PATH}/sse + POST {MCP_PATH}/message. Stateful; use for older clients only.

Configuration

  • .NET 8 SDK (for local development) - A running Gramps Web instance with API access - Docker (optional, for container deployment)
VariableDescriptionRequired
MCP_TRANSPORTConfiguration value read at startup.Optional
GRAMPS_API_URLEndpoint or connection string the server talks to.Yes
GRAMPS_USERNAMEConfiguration value read at startup.Optional
GRAMPS_PASSWORDConfiguration value read at startup.Optional
GRAMPS_TREE_IDConfiguration value read at startup.Optional
GRAMPS_READ_ONLYConfiguration value read at startup.Optional

Example prompts to try

  • “Use Gramps Web MCP to Read.”
  • “Use Gramps Web MCP to Platform.”
  • “Use Gramps Web MCP to Variable.”

Frequently asked questions

MCP server for structured access to Gramps Web genealogy data Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.