mcp-geneanet
Search and read public Geneanet genealogy records (all trees + archive indexes), pull pedigrees, and write them to GEDCOM 7.0 files — read-only toward sources, no account needed.
Search all of Geneanet (
geneanet_search_records): one individual across every public family tree and archive index, filtering by surname, given name, sex, date range/event type, up to 5 places with radius, and parents' names.Search one tree (
geneanet_search_tree): surname and/or first-name prefix matches in a single tree, with parents and spouses.Read a full person (
geneanet_get_person): names, aliases, birth/baptism/death/burial with places and sources, occupation, notes, parents, unions and children, events with witnesses.Walk a family tree (
geneanet_get_tree): ancestors (up to 10 generations), descendants (up to 5) and siblings in one call, with resolved father/mother/parent/spouse links.Check status (
geneanet_auth_status): current settings and, withcheck: true, a live probe of Geneanet's routes to diagnose Cloudflare or markup failures.Note: the README also lists
geneanet_get_people,genealogy_export_gedcomandgenealogy_statuswith GEDCOM export and caching, but these are not present in the supplied server schema.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-geneanet search Geneanet for birth records of Jean Dupont in Paris, 1850–1900"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@mgcrea/mcp-genealogy
A Model Context Protocol server for genealogy records. It reads people out of several genealogy sources, answers in one shared shape whatever the source, and writes what you collect to a GEDCOM 7.0 file.
Source | Status | What it gives |
available | Site-wide search of every public tree and archive index; persons and pedigrees | |
next phase | France's INSEE death index, with exact dates and certificate numbers | |
later | The world tree, with OAuth |
It is read-only toward every source and needs no account. The only thing it writes is the GEDCOM file, in one folder of your choosing.
Tools
Tool | What it does | Requests |
| Search all Geneanet trees and archive indexes at once for one individual | 1 per page |
| Search one tree by surname and/or first name, with each match's parents and spouses | 1 |
| One person's full record: events with places, sources, notes and witnesses | 1 (2 with n/p) |
| Up to 40 people of one tree in one call, | 1 per person |
| Ancestors (up to 10 generations), descendants (up to 5) and siblings, links resolved | 1 |
| Write people, or a pedigree, to a GEDCOM 7.0 file in the export folder | 1 per person not yet read, +1 for a pedigree |
| Each source's settings and the export folder; with | 0, or 1 per check |
People read earlier in the session come from an in-memory cache (one hour), so reading people
with geneanet_get_people and then exporting them does not read anyone twice.
Related MCP server: findagrave-com-mcp
The shared shape
Every tool answers in the same compact JSON. Empty values are left out, never sent as null.
Ref{source, id, url}names a person in a source. A Geneanet id is"<tree>:<index>"("maudrenel1:27"); a family-tree search hit has"<tree>:<surname>/<given names>/<occurrence>"until it is first read, and both forms are accepted wherever a ref is.urlopens the record for a human.DateValue{date, qualifier, dateTo, calendar, text}.dateis ISO, as precise as known ("1870-11-22","1870-11","1870").qualifierisabout,maybe,before,after,between,or,fromorto;dateTois the second bound. A full Julian date is converted back to its own calendar, withcalendar: "julian"; French republican and Hebrew dates, and Julian dates with only a year or month, are not parsed yet and staytext.textholds the source's wording only when it could not be parsed: nothing is guessed.Place{name, code, insee, department, region, country, raw}. Only Geneanet's fulltown, department, region, countryshape is split into slots; anything else keeps the first part asnameand the whole string inraw. A five-character commune code iscodewhen the source does not say what it is (trees write postal codes and INSEE codes alike);inseeis set only by a source that gives INSEE codes, such as Geneanet's INSEE death index. Do not compare one with the other.Citation{source, url, title, text, acte, page}: where a fact comes from.acteandpageare filled only from a source field with that meaning.Brief{ref, name, sex, born, bornAt, died, diedAt, withheld}: a person seen from another record (a parent, spouse, child or search match).bornanddiedare short strings:"1870-11-22","about 1768","between 1825 and 1875".Person{ref, name, given, surname, sex, aliases, occupation, events, parents, families, notes, withheld, withheldReason, detail}.eventsare{type, date, place, citations}(plusnoteandwitnessesinfull).familiesare{spouse, events, children}infull, withchildCountinstead ofchildreninsummary.withheldsays why a record is empty:"private"(the source hides the person),"probably-private"(an empty record with no death, so inferred, withwithheldReasonsaying so), or"premium"(a Geneanet search hit behind theXXXXmask).
Exporting to GEDCOM
genealogy_export_gedcom takes people (refs, as the other tools return them) or a pedigree
(a Geneanet person with ancestors and descendants, read in one request) and writes a GEDCOM 7.0
file. It returns {file, people, families, sources, warnings}, never the file's contents.
The export folder. Files go to
~/Library/Application Support/mcp-genealogy/exports, created on first use, or toGENEALOGY_EXPORT_DIR(an absolute path or~/…). To let a Filiation agent read the exports, pointGENEALOGY_EXPORT_DIRat the folder granted in Filiation › Settings › MCP Server.Names. A new file is
<yyyy-mm-dd>-<surname>.ged, with-2,-3… when taken. Next to it,<file>.refs.jsonlists the refs it holds and thedetailit was written at.One file across calls. Each call reads at most 40 people and stops scheduling new reads after 45 s, so it always answers within about 55 s; whoever was not reached comes back in
remaining. Call again withremainingaspeople, the returnedfileandappend: true: the whole file is rewritten from the people it already holds plus the new ones. An append keeps the file'sdetailunless you pass another, which re-renders every person in it.What the file holds.
HEAD7.0, oneINDIper person,FAMrecords built from the parent and spouse links between people in the file, oneSOURper tree, and on every fact a citation withPAGE(when the source has one) and the record's URL in aNOTE.EXIDkeeps each person's source id. A link to someone left out of the file becomes a warning, never a dangling pointer.
Security
Read-only toward every source. No tool writes to Geneanet or anywhere else online. Geneanet's tree-editing API exists, but nothing here reaches it.
One local write.
genealogy_export_gedcomwrites its.gedand.refs.jsonfiles inside the export folder and nowhere else: afilethat resolves outside it, or is a symlink, is refused before anything is read. It only ever replaces a file it wrote itself, atomically.No credentials. Every route used answers anonymous requests, so there is nothing to leak.
Two runtime dependencies, the MCP SDK and Zod. Native
fetch, and a hand-written protobuf codec (src/sources/geneanet/proto/wire.ts) rather than a protobuf runtime.Paced. At most one Geneanet request per second across all tools by default (
GENEANET_MIN_INTERVAL_MS, minimum 500). Retries are few and short.
Terms of use
Geneanet's terms of service forbid automated access. This server is meant for personal, low-volume research, the kind you would otherwise do by hand in a browser. Do not use it to crawl. The site-wide search also only works because of a gap in Geneanet's bot protection (see How it reaches Geneanet), and that gap can close at any time.
Configure
Variable | Default | Description |
|
| The only folder |
| unset |
|
| none | Default tree for the tree tools: the |
|
| Language of dates and event names in tree answers. |
|
| Minimum gap between two Geneanet requests (500-60000). |
|
| Retries on 429, 5xx and network errors (0-5). |
|
| Per-request deadline (5000-120000). |
|
| Family-tree API host. |
|
| Site-wide search host. |
An out-of-range or malformed value never stops the server. It is replaced by the default or
clamped, and genealogy_status lists what was adjusted.
Quick start
pnpm install
pnpm buildThen add it to your client, for example .mcp.json:
{
"mcpServers": {
"genealogy": {
"command": "node",
"args": ["/absolute/path/to/mcp-genealogy/dist/cli.js"],
"env": { "GENEALOGY_EXPORT_DIR": "~/Documents/Genealogy" }
}
}
}Inspect the tools
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"cli","version":"0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
| node dist/cli.js 2>/dev/null | jq -r '.result.tools[]?.name'Worked example
"Who were Marie Germaine LOUVIGNES's grandparents? She married in Cahuzac-sur-Vère around 1893. Put them in a GEDCOM file."
geneanet_search_records { lastname: "LOUVIGNES", firstname: "Marie Germaine", places: ["Cahuzac-sur-Vère"], radiusKm: 30 }finds her in two family trees,maudrenel1andchantalrochethomas, and in the Tarn marriage index. The tree hits carry arefandtree,nandp.geneanet_get_tree { tree: "maudrenel1", index: 27, ancestors: 2, descendants: 0 }returns her parents, Jean François Paulin LOUVIGNES and Honorine MAUREL, and four grandparents, each withfatherIndexandmotherIndex.geneanet_get_people { tree: "maudrenel1", indexes: [27, 55, 28, 85, 86] }reads five of them: Guilhaume LOUVIGNES (85), for one, was born 1797-03-20 in Gaillac, married 1835-07-02 in Lisle-sur-Tarn and died 1870-01-09 in Cahuzac-sur-Vère.genealogy_export_gedcom { people: [{source: "geneanet", id: "maudrenel1:27"}, …] }writes2026-11-21-louvignes.gedwith 5 people and 3 families without another request, and warns about the links it left out (her husband, and the parents of Honorine, Guilhaume and Antoinette).
How it reaches Geneanet
Geneanet publishes no API. This server uses the same two routes as Geneanet's own pages:
The family-tree API:
POST https://gw.geneanet.org/setup/api/?arbre=<op>&sourcename=<tree>. This is GeneWeb's protobuf API, which the tree pages call themselves (person,graph_v2,person_search_list). Responses are framed as Latin-1 inside UTF-8.proto/README.mdcovers the framing, GeneWeb's raw dates, the privacy flags, and where Geneanet's schema departs from upstream GeneWeb.The site-wide search:
https://en.geneanet.org/fonds/individus/?<form fields>. It answers server-rendered HTML; there is no JSON behind it. Cloudflare challenges every GET from a non-browser client, but the same URL sent as a POST with an empty body gets through. That is a gap in Geneanet's bot protection, not an interface. When it closes, the tools say so (BlockedError, naming Cloudflare) instead of failing obscurely.
Geneanet's "same person in other trees" is not exposed: the profile pages fetch no such list
(see proto/README.md). The site-wide search's family_tree hits are how to find the same
person in other trees.
Traps worth knowing
Indexes are per tree. The same ancestor has a different
indexin every tree. Keep the tree with the index, which arefid does for you.Archive details are Premium-only. For
society_index,collaborative_indexandarchival_registerhits, the search result is all a free account can get. Itsurlopens the record for a human, and the full date may be masked even there (withheld: "premium").Geneanet cannot tell "no such person" from "no such operation". Both come back as an empty answer, which the tools report as a 404 with a remedy.
Vital dates come from the events. The person record holds display dates only, so the ISO form is taken from the matching birth, baptism, death or burial event's raw date. If
eventsLimitcuts that event off, the date is read from the display form instead.Some form filters need Premium. Occupation and spouse names are greyed out on a free account, which is why the search does not offer them.
Troubleshooting
A tool fails with "Cloudflare challenged the request". The route is closed from outside a browser. Run
genealogy_status { check: true }to see which route is affected. The tree tools and the site-wide search are independent."The search page had N result rows but no result count". Geneanet redesigned the results page, and
src/sources/geneanet/records.tsneeds updating against a fresh capture."There is no Geneanet tree named …". The tree name is the first path segment of the tree's URL, not the owner's display name.
The export is refused.
filemust be a.gedname directly in the export folder (genealogy_statusshows it asexportDir), and an existing file is only replaced when this tool wrote it.
Develop
pnpm dev # tsdown --watch
pnpm test # vitest, against real captured responses in test/fixtures
pnpm typecheck
pnpm lint
pnpm formatThe fixtures are real Geneanet answers, captured live with scripts/capture.ts: protobuf bodies
as .bin, and search pages trimmed to their result rows as .html. Recapture them when Geneanet
changes something, rather than editing them by hand.
Publish
pnpm dlx release-it # bump, commit, tag
git push --follow-tags # CI publishes to npm + GHCR from the tagLicense
MIT
Available Tools
5 toolsgeneanet_auth_statusGeneanet: StatusARead-only
Report the server's settings (default tree, request pacing) and, with check: true, whether Geneanet still answers both routes this server uses. No credentials are ever needed: everything read is public. Call this when a tool fails with a Cloudflare or markup error, to tell a site change from a one-off.
Inputs: check.
geneanet_get_personGeneanet: Get PersonARead-only
Read one person's full record from a family tree: names and aliases, birth, baptism, death and burial with places and sources, occupation, notes, parents, every union with its children, and the event list with witnesses. Relatives come back as {index, name, life}; pass an index back here to walk the tree one person at a time, or use geneanet_get_tree for several generations in one call. One request with index, two with n/p.
Inputs: n, p, oc, tree, +2 more.
geneanet_get_treeGeneanet: Get Family Tree Around a PersonARead-only
Ancestors and descendants of one person in a single call, with each relationship already resolved: ancestors carry generation (1 = parents) and fatherIndex/motherIndex; descendants carry relation (child or spouse) with parentIndexes and/or spouseOfIndexes (a cousin marriage has both); siblings are listed too. Names and life years only; use geneanet_get_person on an index for places, sources and notes. One request whatever the depth, but 10 generations can be over a thousand people, so start small.
Inputs: n, p, oc, tree, +3 more.
geneanet_search_recordsGeneanet: Search All RecordsARead-only
Search all of Geneanet at once for one individual: every public family tree plus the archive indexes (genealogical societies' parish and civil register transcriptions, collaborative indexes, archival registers). Each hit says its kind, name, spouse, dates and places, and where it comes from. family_tree hits carry tree/n/p, which geneanet_get_person and geneanet_get_tree take directly. Archive record details are Premium-only on Geneanet, so for other kinds the hit itself is all there is; its url opens the record for a human. One request per page. The same person often appears in several trees, so read the results before fetching any of them.
Inputs: lastname (required), to, sex, from, +11 more.
geneanet_search_treeGeneanet: Search One Family TreeARead-only
Search ONE family tree by surname and/or first name; returns each match's index, dates, parents and spouses, ready for geneanet_get_person. Matching is the tree's own: names starting with what you type, accents ignored. To find people across every tree and the archive indexes, use geneanet_search_records instead. One request.
Inputs: tree, limit, lastname, firstname.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct role: status/diagnostics, broad record search, single-tree search, single-person retrieval, and multi-generation tree retrieval. The descriptions explicitly cross-reference search_records vs. search_tree and get_person vs. get_tree, reducing misselection.
All tools use a consistent geneanet_ snake_case prefix, and most follow a verb_noun pattern (search_records, get_person, get_tree). auth_status is a minor deviation from the action-verb pattern but remains clear and predictable.
Five tools is well-scoped for a read-only genealogy search and retrieval server. Each tool earns its place by covering a distinct layer: diagnostics, broad search, tree-scoped search, person detail, and tree traversal.
The surface covers the core read-only workflows: searching across Geneanet, searching within a tree, fetching a person, traversing ancestors/descendants, and checking service health. Minor gaps exist around explicitly listing or selecting trees, but the default-tree model and available retrieval tools make this workable.
Maintenance
Related MCP Connectors
Read-only OpenHeritage search for genealogy and cultural heritage records.
Read-only lookup of public memorials, funeral notices and partner funeral homes.
Read-only access to your Citlyze workspace: AI search visibility, citations, and recommendations.
Read-only lookup of articles, prayers, Bible verses and courses. No account. Run by Christian Pure.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables direct interaction with FamilySearch.org's shared Family Tree and historical records, including reading and adding people, facts, relationships, sources, notes, memories, record search, and image downloads, without needing a browser.39MIT
- AlicenseAqualityCmaintenanceEnables read-only search and retrieval of Find a Grave memorials, cemeteries, and places, including dates, burial details, inscriptions, biographies, family links, and photos, via the site's anonymous GraphQL API without login.2125MIT
- AlicenseAqualityCmaintenanceEnables searching and reading Fold3 military records, including files, index records, memorials, and collection browsing, along with full-resolution page image downloads, using an existing Ancestry session in read-only mode.6MIT
- AlicenseAqualityBmaintenanceEnables genealogical research against FamilySearch through read-only tools, resolving historical places as they existed at a given date, searching indexed records and collections, fetching the page images behind them, and reading the community-edited shared tree as leads rather than sources. It works anonymously for the gazetteer and catalogue, and uses your own registered application's access token for records, images, and tree access.2865 PyPI1MIT