How do I install the Whatsapp Import Contacts skill?

Run npx skillmds@latest add adam-s-builder-club/whatsapp-import-contacts in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Whatsapp Import Contacts safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Whatsapp Import Contacts?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Whatsapp Import Contacts free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Whatsapp Import Contacts?

Adam-s-Builder-Club (@adam-s-builder-club) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Whatsapp Import Contacts by adam-s-builder-club

Name: Whatsapp Import Contacts
Rating: 4.2 (5 reviews)
Author: Adam-s-Builder-Club

Whatsapp Import Contacts

Re-import contacts into the WhatsApp MCP from a vCard (.vcf) file and/or macOS Contacts.app (via JXA). Updates ~/.whatsapp-mcp/contacts.json so the patched MCP server returns real names instead of raw phone numbers in WhatsApp queries. Use when asked to "refresh whatsapp contacts", "re-import contacts", "update whatsapp names", or after adding new contacts on the phone.

File contents

/whatsapp-import-contacts

Re-imports the user's contacts into the WhatsApp MCP. Equivalent to running install.sh --reimport.

When to use this

User just added new contacts to their phone and wants the names to show up in WhatsApp queries
A WhatsApp chat is showing as a raw phone number (e.g., 919949938166@s.whatsapp.net) instead of a real name
After exporting an updated vCard from iPhone Contacts / Android Google Contacts / Outlook

What it does

Prompts for the ISO region code (US, GB, CA, IN, etc.) if not already set in ~/.whatsapp-mcp/contacts.json's _meta.default_region block
Pulls contacts from macOS Contacts.app via JXA (one-time TCC permission grant)
Optionally merges with a vCard (.vcf) file if the user passes --vcf <path>
Normalizes phone numbers to E.164 via the phonenumbers library (handles UK/AU trunk prefixes, international prefixes, extensions)
Atomically writes ~/.whatsapp-mcp/contacts.json with mode 0600 (refuses destructive empty-overwrite if all sources fail)

How to invoke

bash ~/.whatsapp-mcp/skill-repo/install.sh --reimport

Or with a specific vCard file:

DATA_DIR=~/.whatsapp-mcp uv run --python 3.11 python -m skill.contacts import --vcf ~/Downloads/Contacts.vcf

How to get a vCard file

iPhone (via Mac): Contacts.app → File → Export → Export vCard
iPhone (no Mac): iCloud.com → Contacts → ⚙️ → Select All → Export vCard
Android (Google): contacts.google.com → Export → vCard format
Outlook: People → Manage → Export contacts → CSV → convert to vCard

Privacy

Contact data stays local. ~/.whatsapp-mcp/contacts.json is written with mode 0600 (owner read/write only). Never uploaded anywhere. The patched MCP server reads it from disk on each query.

After re-import

The MCP server picks up the new contacts.json automatically (mtime-cache invalidates on file change). No restart needed.

---name: whatsapp-import-contactsdescription: Re-import contacts into the WhatsApp MCP from a vCard (.vcf) file and/or macOS Contacts.app (via JXA). Updates ~/.whatsapp-mcp/contacts.json so the patched MCP server returns real names instead of raw phone numbers in WhatsApp queries. Use when asked to "refresh whatsapp contacts", "re-import contacts", "update whatsapp names", or after adding new contacts on the phone.---# /whatsapp-import-contactsRe-imports the user's contacts into the WhatsApp MCP. Equivalent to running `install.sh --reimport`.## When to use this- User just added new contacts to their phone and wants the names to show up in WhatsApp queries- A WhatsApp chat is showing as a raw phone number (e.g., `919949938166@s.whatsapp.net`) instead of a real name- After exporting an updated vCard from iPhone Contacts / Android Google Contacts / Outlook## What it does1. Prompts for the ISO region code (US, GB, CA, IN, etc.) if not already set in `~/.whatsapp-mcp/contacts.json`'s `_meta.default_region` block2. Pulls contacts from macOS Contacts.app via JXA (one-time TCC permission grant)3. Optionally merges with a vCard (.vcf) file if the user passes `--vcf <path>`4. Normalizes phone numbers to E.164 via the `phonenumbers` library (handles UK/AU trunk prefixes, international prefixes, extensions)5. Atomically writes `~/.whatsapp-mcp/contacts.json` with mode `0600` (refuses destructive empty-overwrite if all sources fail)## How to invoke```bashbash ~/.whatsapp-mcp/skill-repo/install.sh --reimport```Or with a specific vCard file:```bashDATA_DIR=~/.whatsapp-mcp uv run --python 3.11 python -m skill.contacts import --vcf ~/Downloads/Contacts.vcf```## How to get a vCard file- **iPhone (via Mac):** Contacts.app → File → Export → Export vCard- **iPhone (no Mac):** iCloud.com → Contacts → ⚙️ → Select All → Export vCard- **Android (Google):** contacts.google.com → Export → vCard format- **Outlook:** People → Manage → Export contacts → CSV → convert to vCard## PrivacyContact data stays local. `~/.whatsapp-mcp/contacts.json` is written with mode `0600` (owner read/write only). Never uploaded anywhere. The patched MCP server reads it from disk on each query.## After re-importThe MCP server picks up the new `contacts.json` automatically (mtime-cache invalidates on file change). No restart needed.

Frequently asked questions