authenticate via oauth2 and read a person record from the familysearch family tree api

domain: familysearch.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Register a developer app at developers.familysearch.org to get a client_id; new keys are auto-enabled for the Integration (sandbox) environment only
  2. For web/desktop/mobile apps, call the Authorization resource to redirect the user to the FamilySearch login page with your redirect_uri, receiving an authorization_code back
  3. POST /cis-web/oauth2/v3/token with grant_type=authorization_code, the code, redirect_uri and client_id to get an access_token
  4. For unattended/limited access, use grant_type=unauthenticated_session instead (only works against a small allow-list of resources like Places, Person Search, Date Authority)
  5. Call GET /platform/tree/persons/{id} with Accept: application/x-gedcomx-v1+json and Authorization: Bearer {access_token}
  6. Parse the returned gedcomx document's persons[] array for names, facts (type URIs like http://gedcomx.org/Birth), gender, living flag, and links to spouses/parents/children/sources

Known gotchas

Related routes

Authenticate with Vincere's OAuth2 flow and read/search candidate records
vincere.io · 6 steps · unrated
Read and write people, family, and contribution records in ChMeetings via its Developer API
chmeetings.com · 5 steps · unrated
Authenticate to SAP SuccessFactors using OAuth 2.0 and read a single employee's record via the Employee Central OData v2 API.
help.sap.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans