Skip to content
MCP server

Samecontact

Finds duplicate customers and contacts in CSV exports without merging anything

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About Samecontact

Samecontact is an open-source MCP server for sales and crm. It runs locally on your machine and is started by your AI client.

Matching goes beyond exact dedupe: it understands nicknames, initials, accents, name order, small typos, phone formats, Gmail dots and plus-tags, so Robert Jones and Bob Jones can be grouped. Each pair or group lands in one of three levels with the reason shown: same person, likely, or review where a human should decide. Generic addresses like info@ and free domains do not count as evidence.

The CLI (samecontact find contacts.csv) can write a copy with dup_group and dup_level columns for sorting in a spreadsheet, and never alters the original. It is a single Go binary with no account, key or network code. Limits: CSV only up to 50 MB, name logic aimed at Western names, phones compared by their last 10 digits, and testing so far on made-up data.

MCP results include names from your file and reach whichever model your client uses.

Install

Run in a terminal

claude mcp add samecontact -- npx -y samecontact

Add to claude_desktop_config.json

{
  "mcpServers": {
    "samecontact": {
      "command": "npx",
      "args": [
        "-y",
        "samecontact"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "samecontact": {
      "command": "npx",
      "args": [
        "-y",
        "samecontact"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "samecontact": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "samecontact"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

contacts_find_duplicates
Returns duplicate groups and review pairs, with a limit for large files.
contacts_inspect_csv
Shows detected columns and row counts without row contents.

What it does

Three confidence levels
Same person, likely and review.
Fuzzy name matching
Handles nicknames, accents and typos.
Email and phone normalising
Ignores Gmail dots, plus-tags and formatting.
Marked output file
Adds dup_group and dup_level columns to a copy.
Non-destructive
Never merges or deletes rows.

Good for

  • Clean a CRM export before importing
  • Count unique customers in a list
  • Tidy a mailing list to cut send costs
  • Find shared addresses used by different people

Pricing

Open source

Free, MIT licensed

Samecontact FAQ

Does it merge duplicates?

No. It reports candidates and a person should check them.

Does it upload my data?

The tool has no network code, though MCP results go to your client's model.

Which formats does it read?

CSV, up to 50 MB.

Is Windows supported?

The npm install covers macOS and Linux; on Windows use go install.

Is Samecontact free?

Yes. Samecontact is open source, so you can use and self-host it for free.

How do I add Samecontact to Claude Code?

Run this command in your terminal: claude mcp add samecontact -- npx -y samecontact

What are the best alternatives to Samecontact?

The closest alternatives to Samecontact are Maildignity, Calven, CompanyData, SSRS2 and MisarReach MCP Server.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers