Skip to content
MCP server

Gesher Contacts

Apple Contacts on macOS: search by name, phone or email, edit cards, groups, birthdays…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.1.0
Listing updated
1 day ago

About Gesher Contacts

Gesher Contacts is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Apple Contacts on macOS: search by name, phone or email, edit cards, groups, birthdays, vCard.

Install

Run in a terminal

claude mcp add gesher-contacts -- npx -y https://github.com/EphraimElgrabli/gesher/releases/download/v1.1.0/gesher-contacts-1.1.0.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gesher-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/EphraimElgrabli/gesher/releases/download/v1.1.0/gesher-contacts-1.1.0.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gesher-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/EphraimElgrabli/gesher/releases/download/v1.1.0/gesher-contacts-1.1.0.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gesher-contacts": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/EphraimElgrabli/gesher/releases/download/v1.1.0/gesher-contacts-1.1.0.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "gesher-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/EphraimElgrabli/gesher/releases/download/v1.1.0/gesher-contacts-1.1.0.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "gesher-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/EphraimElgrabli/gesher/releases/download/v1.1.0/gesher-contacts-1.1.0.mcpb"
      ]
    }
  }
}

Pricing

Open source

Gesher Contacts FAQ

Is Gesher Contacts free?

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

How do I add Gesher Contacts to Claude Code?

Run this command in your terminal: claude mcp add gesher-contacts -- npx -y https://github.com/EphraimElgrabli/gesher/releases/download/v1.1.0/gesher-contacts-1.1.0.mcpb