WikiTree MCP Server

A Model Context Protocol (MCP) server that provides access to the WikiTree API. It allows LLMs to browse genealogy data, search for ancestors, and manage watchlists with full authentication support.

Features

• Authenticated Access: Support for WikiTree's interactive clientLogin flow.
• Profile Management: Retrieve detailed profile data and biographies.
• Genealogy Research: Tools for ancestors, descendants, and immediate relatives.
• Watchlist Integration: Access the authenticated user's profile watchlist.
• Session Persistence: Securely stores session cookies locally for seamless reuse.

Installation

You can run the server directly using npx:

npx -y wikitree-mcp

Or install it globally:

npm install -g wikitree-mcp

Authentication

Before using most tools, you must authenticate:

1. Call the login tool via your MCP client.
2. Visit the URL provided in the output.
3. Log in to WikiTree in your browser.
4. Once you see "Login Successful", your session is saved to ~/.wikitree-mcp-cookies.json.

Configuration

Gemini CLI

Add this to your ~/.config/gemini-cli/config.yaml (or equivalent):

mcpServers:
  wikitree:
    command: "npx"
    args: ["-y", "wikitree-mcp"]

Claude Desktop

Add this to your ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "wikitree": {
      "command": "npx",
      "args": ["-y", "wikitree-mcp"]
    }
  }
}

LM Studio

In the MCP settings of LM Studio, add a new server:

• ID: wikitree
• Command: npx
• Args: -y wikitree-mcp

Cursor

Add to Settings > Models > MCP:

• Name: WikiTree
• Type: command
• Command: npx -y wikitree-mcp

Available Tools

• login: Starts the interactive login flow.
• get_profile: Get a person's profile by WikiTree ID (e.g., Washington-1).
• search_person: Search for people by name and dates.
• get_ancestors: Retrieve lineage (ancestors) for a profile.
• get_descendants: Retrieve descendants for a profile.
• get_relatives: Get parents, children, siblings, and spouses.
• get_bio: Get the raw biography text.
• get_watchlist: Get the authenticated user's watchlist.

Development

If you're contributing to the project:

1. Clone the repository.
2. npm install
3. npm run build
4. npm start or point your MCP client to the local dist/index.js.

License

MIT