Samecontact
Finds duplicate customers and contacts in CSV exports without merging anything
- 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 samecontactAdd to claude_desktop_config.json
{
"mcpServers": {
"samecontact": {
"command": "npx",
"args": [
"-y",
"samecontact"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"samecontact": {
"command": "npx",
"args": [
"-y",
"samecontact"
]
}
}
}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.