How do I connect Gramps MCP Server to Claude?

Run `claude mcp add gramps-mcp -- uvx mcpo --port 8000 -- uv run python -m src.gramps_mcp.server stdio` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Gramps MCP Server free?

The listed licence is AGPL-3.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Gramps MCP Server do?

Gramps MCP Server documents 16 tools to the agent, including create_citation, create_event, create_family. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Gramps MCP

Unclaimed

by cabout-me

MCP server for AI-powered genealogy research with Gramps Web API

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'gramps-mcp' -- 'uvx' 'mcpo' '--port' '8000' '--' 'uv' 'run' 'python' '-m' 'src.gramps_mcp.server' 'stdio'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

16 of 16 tools

Documented tools (16)

From project documentation. A server handshake does not verify each tool’s description or behavior.

create_citation

Create or update citations

create_event

Create or update life events

create_family

Create or update family units

create_media

Create or update media files

create_note

Create or update textual notes

create_person

Create or update person records

create_place

Create or update geographic locations

create_repository

Create or update repository records

create_source

Create or update source documents

find_anything

Text search across all genealogy data (matches literal text, not logical combinations)

find_type

Universal search for any entity type (person, family, event, place, source, citation, media, repository) using Gramps Query Language

get_ancestors

Find all ancestors of a person

get_descendants

Find all descendants of a person

get_type

Get comprehensive information about specific persons or families by ID

recent_changes

Track recent modifications to your data

tree_stats

Get tree statistics and information

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Gramps MCP Server

How do I connect Gramps MCP Server to Claude?: Run `claude mcp add gramps-mcp -- uvx mcpo --port 8000 -- uv run python -m src.gramps_mcp.server stdio` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Gramps MCP Server free?: The listed licence is AGPL-3.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Gramps MCP Server do?: Gramps MCP Server documents 16 tools to the agent, including create_citation, create_event, create_family. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.