Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Gramps Evidence

by iandersoversion 2.3.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.ianderso/gramps-evidence-mcp

How to install

What it does

Read/write a self-hosted Gramps Web family tree where every fact carries a citation.

  • Connects Runs on your computer
  • Account or key Needs GRAMPS_MCP_PASSWORD, GRAMPS_MCP_TRANSKRIBUS_PASSWORD · 2 settings to fill in (GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME)
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Gramps Evidence. Follow https://mcp.popnx.com/i/ianderso-gramps-evidence-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Gramps Evidence key (create it on the maker’s site) · 2 setting(s) to fill in (GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Gramps Evidence for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "gramps-evidence": { "command": "uvx", "args": [ "gramps-evidence-mcp" ], "env": { "GRAMPS_MCP_API_URL": "your-value", "GRAMPS_MCP_USERNAME": "your-value", "GRAMPS_MCP_PASSWORD": "your-value", "GRAMPS_MCP_TRANSKRIBUS_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GRAMPS_MCP_PASSWORD, GRAMPS_MCP_TRANSKRIBUS_PASSWORD, GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Gramps Evidence tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Gramps Evidence key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Fill in 2 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • GRAMPS_MCP_API_URL Base URL of your Gramps Web API, e.g. http://gramps.example.org:5000.
    • GRAMPS_MCP_USERNAME A dedicated Gramps Web user with at least the editor role.

    Descriptions are as written by the maker.

  4. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  5. Paste these settings and save the file

    {
      "mcpServers": {
        "gramps-evidence": {
          "command": "uvx",
          "args": [
            "gramps-evidence-mcp"
          ],
          "env": {
            "GRAMPS_MCP_API_URL": "your-value",
            "GRAMPS_MCP_USERNAME": "your-value",
            "GRAMPS_MCP_PASSWORD": "your-value",
            "GRAMPS_MCP_TRANSKRIBUS_PASSWORD": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Quit Claude and open it again

  7. Try it

    Use Gramps Evidence and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Gramps Evidence or shows a Gramps Evidence tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GRAMPS_MCP_CONFIG Absolute path to the TOML file listing reference GEDCOMs and the privacy setting. · default ./gramps_mcp.toml
  • GRAMPS_MCP_EXPOSE_PRIVATE Set true to turn off living-person and private-record filtering of bulk output. · default false
  • GRAMPS_MCP_TRANSKRIBUS_USERNAME Optional. A Transkribus account (Scholar plan or above), for ocr_media's handwriting routes. Every page costs credits.
  • GRAMPS_MCP_TRANSKRIBUS_PAGE_BUDGET Pages a calendar month ocr_media may send to Transkribus without the caller's per-call spend_credits. 0 asks every time. · default 0
  • GRAMPS_MCP_TRANSKRIBUS_API_URL Transkribus' processing API. · default https://transkribus.eu/processing/v1

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Gramps Evidence yet

Gramps Evidence runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Gramps Evidence

  • You need a Gramps Evidence key (create it on the maker’s site) · 2 setting(s) to fill in (GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Gramps Evidence key (create it on the maker’s site) · 2 setting(s) to fill in (GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME) · Install Python (uv) on your computer first (one time)
  • You need a Gramps Evidence key (create it on the maker’s site) · 2 setting(s) to fill in (GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME) · Install Python (uv) on your computer first (one time)
  • You need a Gramps Evidence key (create it on the maker’s site) · 2 setting(s) to fill in (GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME) · Install Python (uv) on your computer first (one time)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Gramps Evidence key (create it on the maker’s site) · 2 setting(s) to fill in (GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Gramps Evidence for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user gramps-evidence --env GRAMPS_MCP_API_URL=your-value --env GRAMPS_MCP_USERNAME=your-value --env GRAMPS_MCP_PASSWORD=your-value --env GRAMPS_MCP_TRANSKRIBUS_PASSWORD=your-value -- uvx gramps-evidence-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GRAMPS_MCP_PASSWORD, GRAMPS_MCP_TRANSKRIBUS_PASSWORD, GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Gramps Evidence tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Gramps Evidence key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Fill in 2 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • GRAMPS_MCP_API_URL Base URL of your Gramps Web API, e.g. http://gramps.example.org:5000.
    • GRAMPS_MCP_USERNAME A dedicated Gramps Web user with at least the editor role.

    Descriptions are as written by the maker.

  4. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  5. Paste this command and press Enter

    claude mcp add --scope user gramps-evidence --env GRAMPS_MCP_API_URL=your-value --env GRAMPS_MCP_USERNAME=your-value --env GRAMPS_MCP_PASSWORD=your-value --env GRAMPS_MCP_TRANSKRIBUS_PASSWORD=your-value -- uvx gramps-evidence-mcp

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Type /mcp in Claude Code

    You should see Gramps Evidence listed as connected

  7. Try it

    Use Gramps Evidence and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Gramps Evidence or shows a Gramps Evidence tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GRAMPS_MCP_CONFIG Absolute path to the TOML file listing reference GEDCOMs and the privacy setting. · default ./gramps_mcp.toml
  • GRAMPS_MCP_EXPOSE_PRIVATE Set true to turn off living-person and private-record filtering of bulk output. · default false
  • GRAMPS_MCP_TRANSKRIBUS_USERNAME Optional. A Transkribus account (Scholar plan or above), for ocr_media's handwriting routes. Every page costs credits.
  • GRAMPS_MCP_TRANSKRIBUS_PAGE_BUDGET Pages a calendar month ocr_media may send to Transkribus without the caller's per-call spend_credits. 0 asks every time. · default 0
  • GRAMPS_MCP_TRANSKRIBUS_API_URL Transkribus' processing API. · default https://transkribus.eu/processing/v1

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Gramps Evidence key (create it on the maker’s site) · 2 setting(s) to fill in (GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Gramps Evidence for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "gramps-evidence": { "command": "uvx", "args": [ "gramps-evidence-mcp" ], "env": { "GRAMPS_MCP_API_URL": "your-value", "GRAMPS_MCP_USERNAME": "your-value", "GRAMPS_MCP_PASSWORD": "your-value", "GRAMPS_MCP_TRANSKRIBUS_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GRAMPS_MCP_PASSWORD, GRAMPS_MCP_TRANSKRIBUS_PASSWORD, GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Gramps Evidence tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Gramps Evidence key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Fill in 2 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • GRAMPS_MCP_API_URL Base URL of your Gramps Web API, e.g. http://gramps.example.org:5000.
    • GRAMPS_MCP_USERNAME A dedicated Gramps Web user with at least the editor role.

    Descriptions are as written by the maker.

  4. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  5. Fill in your key

    In the Gramps Evidence settings, GRAMPS_MCP_PASSWORD, GRAMPS_MCP_TRANSKRIBUS_PASSWORD, GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Open the AI chat in Cursor in Agent mode

  7. Try it

    Use Gramps Evidence and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Gramps Evidence or shows a Gramps Evidence tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GRAMPS_MCP_CONFIG Absolute path to the TOML file listing reference GEDCOMs and the privacy setting. · default ./gramps_mcp.toml
  • GRAMPS_MCP_EXPOSE_PRIVATE Set true to turn off living-person and private-record filtering of bulk output. · default false
  • GRAMPS_MCP_TRANSKRIBUS_USERNAME Optional. A Transkribus account (Scholar plan or above), for ocr_media's handwriting routes. Every page costs credits.
  • GRAMPS_MCP_TRANSKRIBUS_PAGE_BUDGET Pages a calendar month ocr_media may send to Transkribus without the caller's per-call spend_credits. 0 asks every time. · default 0
  • GRAMPS_MCP_TRANSKRIBUS_API_URL Transkribus' processing API. · default https://transkribus.eu/processing/v1

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Gramps Evidence key (create it on the maker’s site) · 2 setting(s) to fill in (GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Gramps Evidence for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "gramps-evidence": { "type": "stdio", "command": "uvx", "args": [ "gramps-evidence-mcp" ], "env": { "GRAMPS_MCP_API_URL": "your-value", "GRAMPS_MCP_USERNAME": "your-value", "GRAMPS_MCP_PASSWORD": "your-value", "GRAMPS_MCP_TRANSKRIBUS_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GRAMPS_MCP_PASSWORD, GRAMPS_MCP_TRANSKRIBUS_PASSWORD, GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Gramps Evidence tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Gramps Evidence key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Fill in 2 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • GRAMPS_MCP_API_URL Base URL of your Gramps Web API, e.g. http://gramps.example.org:5000.
    • GRAMPS_MCP_USERNAME A dedicated Gramps Web user with at least the editor role.

    Descriptions are as written by the maker.

  4. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  5. Fill in your key

    In the Gramps Evidence settings, GRAMPS_MCP_PASSWORD, GRAMPS_MCP_TRANSKRIBUS_PASSWORD, GRAMPS_MCP_API_URL, GRAMPS_MCP_USERNAME is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Open the AI chat in VS Code in Agent mode

  7. Try it

    Use Gramps Evidence and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Gramps Evidence or shows a Gramps Evidence tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GRAMPS_MCP_CONFIG Absolute path to the TOML file listing reference GEDCOMs and the privacy setting. · default ./gramps_mcp.toml
  • GRAMPS_MCP_EXPOSE_PRIVATE Set true to turn off living-person and private-record filtering of bulk output. · default false
  • GRAMPS_MCP_TRANSKRIBUS_USERNAME Optional. A Transkribus account (Scholar plan or above), for ocr_media's handwriting routes. Every page costs credits.
  • GRAMPS_MCP_TRANSKRIBUS_PAGE_BUDGET Pages a calendar month ocr_media may send to Transkribus without the caller's per-call spend_credits. 0 asks every time. · default 0
  • GRAMPS_MCP_TRANSKRIBUS_API_URL Transkribus' processing API. · default https://transkribus.eu/processing/v1

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Gramps Evidence💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user gramps-evidence --env GRAMPS_MCP_API_URL=your-value --env GRAMPS_MCP_USERNAME=your-value --env GRAMPS_MCP_PASSWORD=your-value --env GRAMPS_MCP_TRANSKRIBUS_PASSWORD=your-value -- uvx gramps-evidence-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gramps-evidence": {
      "command": "uvx",
      "args": [
        "gramps-evidence-mcp"
      ],
      "env": {
        "GRAMPS_MCP_API_URL": "your-value",
        "GRAMPS_MCP_USERNAME": "your-value",
        "GRAMPS_MCP_PASSWORD": "your-value",
        "GRAMPS_MCP_TRANSKRIBUS_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "gramps-evidence": {
      "command": "uvx",
      "args": [
        "gramps-evidence-mcp"
      ],
      "env": {
        "GRAMPS_MCP_API_URL": "your-value",
        "GRAMPS_MCP_USERNAME": "your-value",
        "GRAMPS_MCP_PASSWORD": "your-value",
        "GRAMPS_MCP_TRANSKRIBUS_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "gramps-evidence": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gramps-evidence-mcp"
      ],
      "env": {
        "GRAMPS_MCP_API_URL": "your-value",
        "GRAMPS_MCP_USERNAME": "your-value",
        "GRAMPS_MCP_PASSWORD": "your-value",
        "GRAMPS_MCP_TRANSKRIBUS_PASSWORD": "your-value"
      }
    }
  }
}

Values you fill in

  • GRAMPS_MCP_API_URL required env
    Base URL of your Gramps Web API, e.g. http://gramps.example.org:5000.
  • GRAMPS_MCP_USERNAME required env
    A dedicated Gramps Web user with at least the editor role.
  • GRAMPS_MCP_PASSWORD secret required env
    That user's password.
  • GRAMPS_MCP_CONFIG env
    Absolute path to the TOML file listing reference GEDCOMs and the privacy setting.
  • GRAMPS_MCP_EXPOSE_PRIVATE env
    Set true to turn off living-person and private-record filtering of bulk output.
  • GRAMPS_MCP_TRANSKRIBUS_USERNAME env
    Optional. A Transkribus account (Scholar plan or above), for ocr_media's handwriting routes. Every page costs credits.
  • GRAMPS_MCP_TRANSKRIBUS_PASSWORD secret required env
    That Transkribus account's password.
  • GRAMPS_MCP_TRANSKRIBUS_PAGE_BUDGET env
    Pages a calendar month ocr_media may send to Transkribus without the caller's per-call spend_credits. 0 asks every time.
  • GRAMPS_MCP_TRANSKRIBUS_API_URL env
    Transkribus' processing API.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
37/wk
Connection
Runs on your computer
Latest versioni
2.3.0
Categoryi
Other
Published to registryi
Oct 10, 2026
Code last changedi
Nov 14, 2026
Maker
ianderso
Packages
pypi: gramps-evidence-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 18, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account ianderso, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 4 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for gramps-evidence-mcp@2.3.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/ianderso-gramps-evidence-mcp.svg)](https://mcp.popnx.com/en/servers/ianderso-gramps-evidence-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 0% of the other 20575 servers in this category
  • Published to the registry more recently than 53% of the other 20575 servers in this category
  • Basic checks equal to or better than 99% of the other 20575 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Gramps Evidence safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: GRAMPS_MCP_PASSWORD, GRAMPS_MCP_TRANSKRIBUS_PASSWORD

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 4 days ago, and the latest version (2.3.0) reached the registry 39 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.8KUpdated 2 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 29 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
Gramps Evidence
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/41/44/4
LicenseMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

gramps-evidence-mcp

An MCP server that gives an AI assistant read/write access to a Gramps genealogy tree, plus a read-only "reference layer" over legacy GEDCOM exports.

97 tools, built around evidence discipline. The premise is that an assistant turned loose on a family tree will happily invent a plausible ancestor, so the write paths here are shaped to make every claim carry its source: facts are created with citations attached, uncite deletes what it orphans, parent-child links are cited independently because one citation object cannot carry two confidences, and an audit set — list_unsourced_facts, get_backlinks, find_duplicates, and server-side queries through query_objects and query_records — exists to find the places where that discipline slipped.

Legacy trees (Ancestry / FamilySearch exports) are consulted through the read-only reference layer as untrusted hints, never a source of truth.

The server is a REST client of [Gramps Web](https://www.grampsweb.org/) (`gramps-webapi`). It never touches the Gramps database files directly — see How it connects.

Living-person privacy filtering is on by default — see Privacy.

This is an independent project. It is not made, endorsed or supported by the Gramps project.


Contents

  • How it connects
  • Setup
  • Configuration
  • Client configuration
  • Remote access (Claude web / mobile)
  • The evidence model & transactions
  • Privacy
  • Tool reference
  • Reading documents: ocr_media
  • Reference layer (legacy GEDCOMs)
  • Worked example
  • Development
  • Limitations
  • Repository layout

How it connects

The server speaks HTTP to gramps-webapi and never opens the Gramps database files. The API server is the sole owner of the database, so this server and the Gramps Web frontend can both write without contending for the desktop app's exclusive lock. The package imports no gramps.gen.* module and needs no sys.path surgery.

One caveat: *side by side* means the Gramps Web frontend and this server, both talking to the same gramps-webapi. It does not mean pointing the Gramps desktop app at the same database file that gramps-webapi is serving -- that reintroduces the two-writer problem. Treat the Gramps Web tree as the source of truth and round-trip with the desktop app through export/import.

See docs/ARCHITECTURE.md for the layer breakdown.


Setup

You need a running Gramps Web instance, and uv to run the server.

Option A — you already run Gramps Web

If Gramps Web is already up anywhere you can reach, you don't need the bundled docker-compose. Just point the MCP at it:

  1. Note the API base URL, e.g. http://gramps.example.org:5000. The REST API lives under …/api.
  2. Create a dedicated MCP user with at least the editor role (writes need editor; owner also works). From a shell on the Gramps Web host / container:
   gramps-web user add mcp 'A_STRONG_PASSWORD' --fullname 'MCP client' --role 3

(On the official image the wrapper is gramps-web; the underlying command is python3 -m gramps_webapi user add ….)

  1. Put the URL + credentials in your environment (see Configuration).
Option B — run Gramps Web locally with the bundled compose

A ready-to-go stack is in docker/docker-compose.yml: SQLite backend, bind-mounted data and media directories (a plain directory tree you can copy or back up like any other), and host port 5555 → container 5000. Port 5555 avoids macOS's AirPlay Receiver, which occupies 5000.

docker compose -f docker/docker-compose.yml up -d

Then create the first owner (browser wizard at http://localhost:5555, or CLI) and the dedicated MCP editor user:

docker compose -f docker/docker-compose.yml exec grampsweb \

gramps-web user add owner 'OWNER_PW' --fullname 'Owner' --role 4 docker compose -f docker/docker-compose.yml exec grampsweb \ gramps-web user add mcp 'MCP_PW' --fullname 'MCP client' --role 3

The tree named by GRAMPSWEB_TREE (default MyTree) is created on first start.

Install the MCP server
uvx gramps-evidence-mcp

That runs the server over stdio, which is how an MCP client starts it. You normally put it in the client's configuration (below) rather than running it yourself.


Configuration

Secrets live in the environment; everything else in a TOML file. The TOML file therefore never contains credentials.

Environment variables

Set them in the client configuration, or in a .env file in the directory the server starts in (see .env.example). Real environment variables win over the file.

VarMeaning
GRAMPS_MCP_API_URLBase URL of gramps-webapi, e.g. http://gramps.example.org:5000
GRAMPS_MCP_USERNAMEThe dedicated MCP user
GRAMPS_MCP_PASSWORDIts password
GRAMPS_MCP_CONFIGPath to the TOML config (default ./gramps_mcp.toml, from the working directory)
GRAMPS_MCP_EXPOSE_PRIVATEOverride the TOML expose_private flag
GRAMPS_MCP_TRANSPORTstdio (default) or http — see Remote access
GRAMPS_MCP_HOST, GRAMPS_MCP_PORTWhere http listens (default 127.0.0.1:8090)
GRAMPS_MCP_TRANSKRIBUS_USERNAME, GRAMPS_MCP_TRANSKRIBUS_PASSWORDOptional. A Transkribus account (Scholar plan or above), for ocr_media's handwriting routes. Both or neither. See Reading documents
GRAMPS_MCP_TRANSKRIBUS_PAGE_BUDGETPages a calendar month ocr_media may send to Transkribus without the caller's per-call spend_credits. Default 0: every page asks
GRAMPS_MCP_TRANSKRIBUS_API_URLTranskribus' processing API (default https://transkribus.eu/processing/v1, Metagrapho v1)
TOML file (see gramps_mcp.example.toml)
[server]

expose_private = false # see Privacy below

[[reference]] path = "~/gedcoms/export_one.ged" label = "Ancestry (one branch)" trust = "User-built; many hints unsourced. Verify everything."

A desktop client starts the server in a directory of its own choosing, so give GRAMPS_MCP_CONFIG as an absolute path.


Client configuration

Claude Desktop — add to claude_desktop_config.json (on macOS, ~/Library/Application Support/Claude/):

{

"mcpServers": { "gramps": { "command": "uvx", "args": ["gramps-evidence-mcp"], "env": { "GRAMPS_MCP_API_URL": "http://gramps.example.org:5000", "GRAMPS_MCP_USERNAME": "mcp", "GRAMPS_MCP_PASSWORD": "MCP_PW", "GRAMPS_MCP_CONFIG": "/path/to/gramps_mcp.toml" } } } }

Claude Code:

claude mcp add gramps \

-e GRAMPS_MCP_API_URL=http://gramps.example.org:5000 \ -e GRAMPS_MCP_USERNAME=mcp -e GRAMPS_MCP_PASSWORD=MCP_PW \ -e GRAMPS_MCP_CONFIG=/path/to/gramps_mcp.toml \ -- uvx gramps-evidence-mcp

Any other MCP client that launches stdio servers works the same way: the command is uvx gramps-evidence-mcp, with the variables above in its environment. Restart the client after editing its configuration.

To run from a clone instead, replace uvx gramps-evidence-mcp with uv --directory /path/to/gramps-evidence-mcp run gramps-evidence-mcp.


Remote access (Claude web / mobile)

The configuration above uses the stdio transport: the client launches the server as a local subprocess. Claude web (claude.ai) and the mobile apps can't do that — they connect to a remote server over HTTPS using the *Streamable HTTP* transport, added as a Custom Connector. Three differences to plan for:

  1. Transport must be HTTP, not stdio.
  2. Reachability — Anthropic's servers dial *out* to yours, so it needs a public HTTPS URL. A LAN address like http://192.168.1.50:5000 won't work.
  3. Auth — it's write access to a database of living relatives, so it must sit behind authentication. The server has none of its own. Never expose it authless.

If you don't specifically need a browser/phone, **a desktop client already

gives you the same models with this server working locally** (stdio, no

public exposure). The steps below are only for genuine remote access.

1. Serve it over HTTP
GRAMPS_MCP_TRANSPORT=http uvx gramps-evidence-mcp

That serves the MCP endpoint at http://127.0.0.1:8090/mcp; GRAMPS_MCP_HOST and GRAMPS_MCP_PORT change where. The other GRAMPS_MCP_* variables apply as before.

Bound to a loopback address, the server accepts only requests whose Host is localhost or 127.0.0.1 — the MCP SDK's protection against DNS rebinding. A tunnel or proxy on the same machine must therefore send Host: localhost (cloudflared's httpHostHeader setting does this). In a container, bind 0.0.0.0 instead, as below, and let the container network do the isolating.

2. Deploy it next to Gramps Web

Run it in a container on the same host as Gramps Web so it talks to the API over the internal network. A minimal Dockerfile:

FROM python:3.13-slim

RUN pip install uv ENV GRAMPS_MCP_TRANSPORT=http GRAMPS_MCP_HOST=0.0.0.0 GRAMPS_MCP_PORT=8090 EXPOSE 8090 CMD ["uvx", "gramps-evidence-mcp"]

Add it to your Gramps Web compose (same network), pointing at the API by service name and reading secrets from the environment:

  gramps_evidence_mcp:

build: /path/to/dockerfile-dir restart: unless-stopped environment: GRAMPS_MCP_API_URL: "http://grampsweb:5000" # internal service name GRAMPS_MCP_USERNAME: "mcp" GRAMPS_MCP_PASSWORD: "${MCP_PW}"

no host port needed if the tunnel (below) runs in the same compose network

3. Expose it publicly with TLS

A reverse tunnel avoids port-forwarding and gives you TLS and a stable hostname. Any of these work:

  • Cloudflare Tunnel — run cloudflared alongside the server and route a hostname such as https://gramps-mcp.example.org → http://gramps_evidence_mcp:8090.
  • Tailscale Funnel — public HTTPS over your own tailnet.
  • ngrok http 8090 for a quick throwaway test.

Or terminate TLS yourself with any reverse proxy in front of port 8090.

4. Put auth in front

claude.ai custom connectors speak the MCP OAuth 2.0 flow. Put an identity proxy in front of the tunnel hostname — Cloudflare Access, Authelia, oauth2-proxy and similar all tie into the OAuth flow the connector expects. The server does not authenticate callers itself; see docs/ROADMAP.md.

5. Add the connector in claude.ai

Settings → Connectors → Add custom connector → paste https://gramps-mcp.example.org/mcp, complete the auth prompt, and the 97 tools appear in chat. (Custom connectors require a paid Claude plan; on Team/Enterprise an admin may need to enable them.)

Security reminder: this endpoint can create, edit, and delete records in a tree containing living people. Keep it behind auth, prefer a private tunnel over an open port, and consider a Gramps Web user with a read-only role if you only need lookups r

Only the beginning is shown; read the rest in the repo