# Samecontact

> Samecontact is an open-source MCP server for sales and crm. Finds duplicate customers and contacts in CSV exports without merging anything. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/gillmacedo/samecontact
- **MCP Registry name:** io.github.GillMacedo/samecontact
- **Categories:** [sales and CRM](https://ai-powered.com/categories/sales-and-crm), [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add samecontact -- npx -y samecontact
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Maildignity](https://ai-powered.com/mcp/maildignity-2): Maildignity is a freemium MCP server for sales and crm.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.
- [Zovo PDF to Spreadsheet](https://ai-powered.com/mcp/zovo-pdf-to-spreadsheet): Zovo PDF to Spreadsheet is an MCP server for files and documents.
- [Zovo Graph Paper](https://ai-powered.com/mcp/zovo-graph-paper): Zovo Graph Paper is an MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/samecontact
