Gramps MCP MCP Server

Name: Gramps MCP MCP Server
Author: oliverhruby

oliverhruby

MCP server with full coverage of the Gramps Web API REST endpoint functionality. Super-powers for your genealogy research with the help of AI.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

Local

claude mcp add gramps-mcp --env GRAMPS_MCP_USERNAME='<GRAMPS_MCP_USERNAME>' --env GRAMPS_MCP_PASSWORD='<GRAMPS_MCP_PASSWORD>' -- uvx gramps-mcp-full

~/.codex/config.toml

[mcp_servers.gramps-mcp]
command = "uvx"
args = ["gramps-mcp-full"]
env = { GRAMPS_MCP_USERNAME = "<GRAMPS_MCP_USERNAME>", GRAMPS_MCP_PASSWORD = "<GRAMPS_MCP_PASSWORD>" }

# codex mcp add gramps-mcp --env GRAMPS_MCP_USERNAME='<GRAMPS_MCP_USERNAME>' --env GRAMPS_MCP_PASSWORD='<GRAMPS_MCP_PASSWORD>' -- uvx gramps-mcp-full

~/.cursor/mcp.json

{
  "mcpServers": {
    "gramps-mcp": {
      "command": "uvx",
      "args": [
        "gramps-mcp-full"
      ],
      "env": {
        "GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
        "GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "gramps-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gramps-mcp-full"
      ],
      "env": {
        "GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
        "GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "gramps-mcp": {
      "command": "uvx",
      "args": [
        "gramps-mcp-full"
      ],
      "env": {
        "GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
        "GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "gramps-mcp": {
      "command": "uvx",
      "args": [
        "gramps-mcp-full"
      ],
      "env": {
        "GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
        "GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "gramps-mcp": {
      "command": "uvx",
      "args": [
        "gramps-mcp-full"
      ],
      "env": {
        "GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
        "GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
      }
    }
  }
}

Remote

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

~/.codex/config.toml

[mcp_servers.gramps-mcp]
url = "https://ghcr.io/oliverhruby/gramps-mcp:latest"

# codex mcp add gramps-mcp --url https://ghcr.io/oliverhruby/gramps-mcp:latest

~/.cursor/mcp.json

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

.vscode/mcp.json

{
  "servers": {
    "gramps-mcp": {
      "type": "http",
      "url": "https://ghcr.io/oliverhruby/gramps-mcp:latest"
    }
  }
}

~/.gemini/settings.json

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

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "gramps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ghcr.io/oliverhruby/gramps-mcp:latest"
      ]
    }
  }
}

.trae/mcp.json

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

Environment variables

GRAMPS_MCP_USERNAME
GRAMPS_MCP_PASSWORD

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Local

Remote

Environment variables

Related