# GoldenMatch

GoldenMatch finds rows for the same person, company, or product and combines duplicates into a merged record. Use it to clean up CSV files or tables with inconsistent entries.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 133
- Author: benseverndev-oss
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/benseverndev-oss/goldenmatch
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/goldenmatch

## What it does

GoldenMatch links records that refer to the same entity even when their field values differ. It can group name, phone, and address variants, while keeping entries with only a shared postal code separate. Each duplicate group produces a merged record assembled from suitable field values.

The server selects matching settings on its own and returns the configuration it chose. Results include duplicate clusters, records without matches, and merged entries; CSV runs also write result files. The project offers a Python API and CLI. In Claude Code, connect over HTTP or launch the server through `uvx`.

Local use requires Python 3.11 or later. That version requirement matters if you plan to run GoldenMatch through `uvx`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://goldenmatch-mcp-production.up.railway.app/mcp/`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http goldenmatch https://goldenmatch-mcp-production.up.railway.app/mcp/
```

2. **Platform CLI**
```bash
claude mcp add goldenmatch -- uvx goldenmatch
```
uvx runs the command named after the package; if the README names another one, use uvx --from goldenmatch <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add goldenmatch --url https://goldenmatch-mcp-production.up.railway.app/mcp/
```

2. **Platform CLI**
```bash
codex mcp add goldenmatch -- uvx goldenmatch
```
uvx runs the command named after the package; if the README names another one, use uvx --from goldenmatch <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "goldenmatch": {
            "url": "https://goldenmatch-mcp-production.up.railway.app/mcp/"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "goldenmatch": {
            "command": "uvx",
            "args": [
                "goldenmatch"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from goldenmatch <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "goldenmatch": {
            "type": "http",
            "url": "https://goldenmatch-mcp-production.up.railway.app/mcp/"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "goldenmatch": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "goldenmatch"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from goldenmatch <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http goldenmatch https://goldenmatch-mcp-production.up.railway.app/mcp/
```

2. **Platform CLI**
```bash
gemini mcp add goldenmatch uvx goldenmatch
```
uvx runs the command named after the package; if the README names another one, use uvx --from goldenmatch <command>

## When to use it
- find person records with different names or phone formats
- group duplicate rows in a CSV
- combine fields from matching records
- separate duplicate groups from unmatched entries

## Example prompts
- Find duplicate people in `customers.csv` and merge each group into one record.
- Match rows in this CSV despite variations in names, phone numbers, and addresses.
- Show the matched groups and return their merged records.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md