Gramps MCP MCP Server

A Model Context Protocol (MCP) server that exposes the full functionality of the Gramps Web API to AI agents such as opencode, Claude, Cursor and any other MCP client. It is published on PyPI as gramps-mcp-full. Its 27 documented tools cluster into manage, read & search, ping, merge.

People who work with manage and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-21 · ★ 2 · #273 OF 292 MAINTAINED API INTEGRATION · VERIFIED 2026-09-30

MIT · Python servers · how we verify → /methodology

01 · Install Gramps MCP MCP Server

before you install - you'll need

Set GRAMPS_MCP_USERNAME, GRAMPS_MCP_PASSWORD before connecting. GRAMPS_MCP_INSTANCES is optional or environment-specific per the README.

Claude Code

claude mcp add oliverhruby-gramps-mcp --transport http https://ghcr.io/oliverhruby/gramps-mcp:latest

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "oliverhruby-gramps-mcp": {
      "url": "https://ghcr.io/oliverhruby/gramps-mcp:latest"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://ghcr.io/oliverhruby/gramps-mcp:latest

transport: streamable-http

endpoint responds (non-MCP reply - review) · probed 2026-09-30

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to ghcr.io

repo age created 2026-09-16 - young repo, little track record yet

license MIT - declared in the repository

pypi package gramps-mcp-full - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.oliverhruby is GitHub-verified and matches the repo owner

03 · What Gramps MCP MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list configured Gramps Web instances, list importers or import a file (Gramps XML, GEDCOM…), list exporters or produce an export (GEDCOM, Gramps XML…), and list, configure or generate reports (PDF, text, web…).

Capability map

Tools grouped from the project's README - what Gramps MCP MCP Server lets an agent do.

Manage

18 tools - e.g. CRUD Person records (action = get/list/create/update/delete).; CRUD Family records (father/mother/children refs maintained upstream).; CRUD Event records (types from manage_type).

manage_person · manage_family · manage_event · manage_place · manage_source · manage_citation…

read & search

6 tools - e.g. List configured Gramps Web instances.; Full-text or semantic search, filterable by object type.; Chronological event timeline for a person, family, or whole tree.

get_instances · search · get_timeline · get_relation · get_living · get_server_info

Ping

1 tool - e.g. Health check.

ping

Merge

1 tool - e.g. Merge two objects of the same type into one.

merge_objects

Analyze

1 tool - e.g. DNA match analysis and raw match-string parsing.

analyze_dna

Limitations (from the README)

- Depends on the official Gramps Web API. Field coverage follows the upstream gramps-project/gramps-web-api REST schema; object payloads use Gramps handle/gramps_id conventions. - Write tools mutate real data with no confirmation layer. Never run destructive tool-calls you don't understand; the server does not add an extra confirmation prompt on top of the API. - Auth lives for the process lifetime. Sessions are crea

Latest releases

v0.2.0 · 2026-09-21

gramps-mcp-full v0.2.0 · New - optional read-only mode · Added the GRAMPS_MCP_READONLY environment variable. Set it to 1, true or yes to run the server in read-only mode: every write action in the shared CRUD helper…

v0.1.0 · 2026-09-17

grampsweb container integration gate · New Contributors · @oliverhruby made their first contribution in

04 · Who maintains Gramps MCP MCP Server

Gramps MCP MCP Server is maintained by oliverhruby. We track 2 MCP servers from oliverhruby - 2 actively maintained, 3 combined GitHub stars, oldest repo from Sep 2026.

05 · Facts

repository
github.com/oliverhruby/gramps-mcp
website
https://github.com/oliverhruby/gramps-mcp
category
API integration - ranked #273 of 292 actively-maintained API integration servers as of 2026-09-30.
release cadence
2 releases in the last 90 days (latest 2026-09-21)
registry
io.github.oliverhruby/gramps-mcp (active, first published 2026-09-21)
packages
pypi:gramps-mcp-full

06 · Gramps MCP MCP Server FAQ

Is Gramps MCP MCP Server still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-21 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Gramps MCP MCP Server do?

With this server connected, an agent can list configured Gramps Web instances, list importers or import a file (Gramps XML, GEDCOM…), list exporters or produce an export (GEDCOM, Gramps XML…), and list, configure or generate reports (PDF, text, web…).

How do I install Gramps MCP MCP Server?

Run `uvx gramps-mcp-full`. The README documents 3 environment variables (GRAMPS_MCP_INSTANCES, GRAMPS_MCP_USERNAME, GRAMPS_MCP_PASSWORD) to set first. Set GRAMPS_MCP_USERNAME, GRAMPS_MCP_PASSWORD before connecting. GRAMPS_MCP_INSTANCES is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Gramps MCP MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Gramps MCP MCP Server

Alternatives to Gramps MCP MCP Server

Maintained API integration servers if Gramps MCP MCP Server isn't the fit.

  1. LetsFG - Flights & Hotels Search and book flights and hotels: hundreds of airlines, plus bookable hotel rates. ★ 2,075 · 2026-09-29
  2. Microsoft 365 MCP Server Interact with Microsoft 365 and Office services through the Microsoft Graph API. ★ 1,002 · 2026-09-29
  3. Idea Reality MCP Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt - returns 0-100 signal. ★ 823 · 2026-09-18
  4. Tapo MCP MCP server for discovering and controlling TP-Link Tapo smart home devices via AI Agents ★ 810 · 2026-09-29
  5. Sv Number MCP Server Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back. ★ 551 · 2026-08-10
  6. Anytype MCP Official MCP server for Anytype API - your encrypted, local and collaborative wiki. ★ 528 · 2026-09-21

More API integration MCP servers · Orbis API Marketplace · Bruno MCP Studio · Admob MCP Server · Odoo MCP Gateway · Graph Polymarket MCP

More Python MCP servers · Omega Memory MCP Server · OMEGA Memory · mneme Record · OpenAdapt Agent (openadapt-flow bridge) · MinerU Open MCP · see all