genealogyresearchfamily-treesgramps-webdata-management
Connects AI clients to Gramps Web for genealogy search, relationship analysis, and controlled record management.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Remote HTTPConfigure Environment Variables (API Keys, Tokens, Options):
Add required secrets below — values are included directly in the generated snippet so you can copy and paste with confidence.
Quick Add:
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Search family-tree records from an AI client
Trace ancestors and descendants
Review relationships and genealogy timelines
Add or update records through guided workflows
Inspect permitted genealogy media
Key features
57 tools for genealogy records
Full-text search and paginated browsing
Ancestor, descendant, relationship, and timeline queries
Read-only mode for blocking mutations
MCP resources and guided prompts
stdio, Streamable HTTP, and legacy SSE transports
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Gramps Web MCP.
Extracted Tool Capabilities
57 tools for genealogy records
Full-text search and paginated browsing
Ancestor, descendant, relationship, and timeline queries
Read-only mode for blocking mutations
MCP resources and guided prompts
stdio, Streamable HTTP, and legacy SSE transports
How Gramps Web MCP works
What Gramps Web MCP does
Gramps Web MCP MCP server connects AI agents to an existing Gramps Web genealogy installation. It is an integration layer rather than a genealogy application: Gramps Web continues to provide the user interface, accounts, permissions, family trees, media, and primary editing environment.
The server exposes structured access to people, families, events, places, sources, citations, notes, media, repositories, and tags. Agents can search and browse records, examine family relationships, and perform record operations when write access is enabled. A read-only setting keeps the tools available while preventing create, update, and delete operations.
How it works
Gramps Web MCP MCP server authenticates against a running Gramps Web instance with four required connection settings: the API base URL, username, password or token, and tree UUID. It can run locally over stdio for desktop clients or as an HTTP service using Streamable HTTP. Legacy SSE transport is also supported.
The HTTP deployment exposes the MCP endpoint at /mcp and a /health endpoint for checking whether the service can authenticate to Gramps Web. An optional MCP API key can protect requests when the service is reachable from other machines. Clients send that key as a bearer token or through the X-Api-Key header.
Setup and configuration
Local development requires the .NET 8 SDK. Docker images are published for Linux AMD64 and ARM64, and the project also documents Docker Compose, Unraid, and a packaged Claude Desktop extension. The Claude Desktop bundle runs locally over stdio and does not require the .NET SDK on the client machine.
Set GRAMPS_API_URL, GRAMPS_USERNAME, GRAMPS_PASSWORD, and GRAMPS_TREE_ID before starting the service. Set GRAMPS_READ_ONLY=true to block mutations. For an HTTP deployment that needs request authentication, configure MCP_API_KEY. The default HTTP port is 8080, with the MCP endpoint at /mcp.
Tools and capabilities
Gramps Web MCP MCP server includes 57 MCP tools covering:
- Full-text search and paginated object listing
- Reading, creating, updating, and deleting genealogy records
- Ancestor, descendant, relationship, and timeline queries
- Composite actions such as adding a person or attaching an event to a person
- Lookup by Gramps ID
- Optional media thumbnail and file retrieval
It also provides six MCP resources for type vocabularies, input guidance, tree metadata, name settings, and optional media content. Media access includes size limits, MIME-type allowlists, and private-record defaults. Vision-capable clients may receive image, audio, or embedded blob content when the relevant media access is enabled.
MCP prompts guide research, person and family creation, and import workflows. These prompts and tools can be used through clients such as Claude Desktop and Cursor.
Limitations and notes
The Gramps Web MCP MCP server requires a reachable Gramps Web instance with API access; it does not store or manage a standalone genealogy database. The available records and permitted operations therefore depend on the selected tree and the credentials used to connect.
Write operations should be treated separately from research or browsing use. Read-only mode is available for safer initial sessions and can be enabled in container or stdio configuration. Media analysis also depends on the MCP client forwarding typed tool content or binary resource content to a model that supports it.
The project is licensed under AGPL v3. Its documented local development path uses .NET 8, while Docker and the Claude Desktop bundle provide alternatives for deployment or client installation.
Getting started with this Gramps Web MCP MCP server
Always refer to the official documentation for the most accurate and up-to-date information.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
12
Stargazers on the source repository.
Last commit
16d ago
Most recent push to the default branch.
Directory activity
3 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Gramps Web MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/gramps-web-mcp)HTML Embed
<a href="https://allmcps.com/mcp/gramps-web-mcp"><img src="https://allmcps.com/api/badge/gramps-web-mcp?style=directory" alt="Gramps Web MCP on AllMCPs" /></a>Technical Specs & Signals
CategoryResearch
PricingFree
3/7 checks healthy over the last 45d
43Quality signal: Fair · 43/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools16/30
Adoption & activity6/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.