VCF (vCard) to JSON Converter

What does this tool do?

It parses .vcf vCard files — the standard contact-exchange format used by phones, email clients, and address books — into structured JSON you can process, import into another system, or inspect. It handles both vCard 3.0 (RFC 2426) and vCard 4.0 (RFC 6350), including files containing multiple contacts back to back.

How this tool works

1. Paste vCard content into the text box, or upload a .vcf file directly.
2. Toggle the parsing options to control the output shape:
   • Pretty-print — indent the JSON for readability, or minify it.
   • Flat array — output contacts as a plain array, or wrap them in a { count, contacts } object.
   • Split N / Split ADR — break the structured name and address fields into labeled parts (family, given, street, locality, etc.) instead of leaving them as raw semicolon-delimited strings.
   • Parse dates — convert BDAY/ANNIVERSARY/REV into ISO 8601 format.
   • Group by type — bucket multi-value fields like EMAIL and TEL by their TYPE parameter (work, home, cell) instead of a flat list.
   • Include photo data — keep base64-encoded PHOTO/LOGO values in the output (off by default, since these can be large).
   • Include raw values — keep the original unparsed property value alongside the parsed one.

What gets parsed

Long folded lines are unfolded per the vCard line-folding rule, and each property line's group prefix, parameters, and value are parsed according to the vCard grammar — including quoted parameter values. Structured properties (N, ADR, ORG) are split into their component parts; EMAIL and TEL values have mailto:/tel: URI prefixes stripped; GEO coordinates are parsed into { lat, lon }; multiple values of the same property (like two phone numbers) are sorted by their PREF parameter, most preferred first. Any parsing issues are collected into an errors array rather than aborting the whole conversion.

Common uses

• Converting an exported .vcf address book into JSON for import into another system
• Extracting structured contact data (names, emails, phone numbers) from a vCard for further processing
• Inspecting a vCard's exact fields and parameters when debugging contact-sync issues
• Bulk-converting multiple contacts from one file into a JSON array

Privacy

This tool runs entirely in your browser. Your contact data is never uploaded to a server.