@griches/apple-contacts-mcp

An MCP server that gives AI assistants access to Apple Contacts on macOS via AppleScript.

Quick Start

npx @griches/apple-contacts-mcp

Tools

| Tool | Description | |------|-------------| | list_groups | List all groups in Apple Contacts | | list_contacts | List all contacts, optionally filtered by group | | get_contact | Get full details of a contact (emails, phones, addresses, etc.) | | search_contacts | Search contacts by name | | create_contact | Create a new contact with optional email, phone, organization | | update_contact | Update an existing contact's details | | delete_contact | Delete a contact by name | | create_group | Create a new group | | delete_group | Delete a contact group | | add_contact_to_group | Add a contact to a group | | remove_contact_from_group | Remove a contact from a group |

Configuration

Claude Code

claude mcp add apple-contacts -- npx @griches/apple-contacts-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "apple-contacts": {
      "command": "npx",
      "args": ["@griches/apple-contacts-mcp"]
    }
  }
}

Requirements

• macOS (uses AppleScript)
• Node.js 18+

License

MIT — see the main repository for full details.