Sheet to VCF

About

Turn any Google Sheet into a ready-to-import vCard 4.0 (.vcf) contact file in seconds. No sign-in. No API keys. No data ever leaves your browser.

Sheet to VCF is the fastest, most private way to convert spreadsheet contact data into the universal vCard format used by Google Contacts, Apple Contacts, Outlook, Thunderbird, and every smartphone on the planet.

How It Works

Open any Google Sheet that contains contact information — names, phone numbers, emails, addresses, or any combination — and click the Sheet to VCF icon in your toolbar. The extension instantly reads your sheet, intelligently detects which columns correspond to which contact fields, and presents you with a clean mapping interface. Review the auto-detected mappings, adjust anything you want with simple dropdowns, and hit Export. Your .vcf file downloads immediately, ready to import anywhere.

That's it. Three clicks from spreadsheet to contacts.

Smart Auto-Detection

Sheet to VCF doesn't just blindly guess. It uses a sophisticated two-layer detection system to figure out what your columns mean:

First, it analyzes your column headers against 35+ matching rules covering common naming patterns in eight languages — English, German, French, Spanish, Dutch, Turkish, Persian (Farsi), and Arabic. Whether your header says "Phone Number", "Telefon", "شماره موبایل", or "رقم الهاتف", Sheet to VCF recognizes it.

Second, it samples the actual cell data and runs pattern recognition to identify phone numbers, email addresses, URLs, dates, postal codes, and names — even if your headers are cryptic or missing. The two layers work together with a scored conflict resolution system to produce the most accurate mapping possible.

Every auto-detected mapping is fully editable. You always have the final say.

Full vCard 4.0 Support

This isn't a basic CSV-to-VCF converter. Sheet to VCF supports over 40 vCard fields organized across every category the standard defines:

Names — Full name, first name, last name, middle name, prefix (Dr., Mr., etc.), suffix (Jr., PhD), and nickname. The extension properly generates both the structured N field and the display FN field per the vCard specification.

Phone numbers — Mobile, work, home, fax, voice, pager, and generic phone types. Numbers are automatically normalized: formatting characters are stripped, international prefix handling converts "00" to "+", and local trunk digits are preserved.

Email — Personal, work, and internet email types with proper TYPE parameters.

Addresses — Full home and work addresses with separate street, city, state/province, postal code, and country components, all mapped to the structured ADR field.

Organization — Company name, job title, role, and logo URL.

Dates — Birthday and anniversary in vCard-compliant format.

Everything else — Photo URL, website, notes, categories/tags, instant messaging (IMPP for Skype, Telegram, WhatsApp, XMPP, etc.), and PGP public key.

Flexible Name Handling

Not every spreadsheet has a name column, especially phone number lists or bulk data exports. When Sheet to VCF detects that no name column is mapped, it doesn't just block you — it opens a dialog offering two smart options: pick any existing column to use as the contact name (such as a phone number or company name), or type a fixed name that applies to every contact (like "Imported Contact" or "WhatsApp Export"). Either way, you get valid, importable vCards.

100% Private — Zero Data Collection

Sheet to VCF processes everything locally inside your browser. Here's exactly what happens technically: the extension reads your active tab's URL to detect if you're on a Google Sheet, then runs a same-origin fetch inside that tab to download the sheet as CSV using your existing Google session. The CSV is parsed, mapped, and converted to vCard text entirely in memory. The resulting file is saved through Chrome's downloads API. At no point is any data sent to any external server, analytics service, or third party.

No OAuth tokens. No Google API keys. No cloud functions. No tracking. No telemetry. Nothing.

Works With Any Google Sheet

If you can view a Google Sheet in your browser, Sheet to VCF can convert it. Your own spreadsheets, shared sheets, published sheets — if it's open in a tab, it works. The extension supports sheets with any number of rows and columns, handles quoted fields with embedded commas and newlines, and correctly processes Unicode text in any language.

Lightweight and Fast

The entire extension is under 60KB. Pure vanilla JavaScript and CSS — no frameworks, no dependencies, no build tools. It loads instantly and runs without lag even on large sheets with thousands of rows.

Open Source

Sheet to VCF is free and open source under the MIT license. The full source code is available at github.com/sepehr-mohseni/sheet-to-vcf. Audit it, fork it, improve it.

Perfect For

• Migrating contacts from spreadsheets to your phone
• Converting CRM exports to importable contact files
• Bulk creating contacts from mailing lists or sign-up sheets
• Backing up Google Sheets contact data as vCards
• Converting WhatsApp or messaging app contact exports
• Any spreadsheet-to-contacts workflow