vCard to JSON

Convert vCard contacts to JSON

Paste one or more vCard (.vcf) contact cards and get back a clean JSON array of contacts. The parser understands vCard 2.1, 3.0 (RFC 2426), and 4.0 (RFC 6350) — including folded continuation lines, multiple cards in one file, group prefixes like item1.TEL, and value escapes (\n, \,, \;, \\). Everything runs locally in your browser; your contacts are never uploaded.

Worked example

Input:

BEGIN:VCARD
VERSION:3.0
FN:John Doe
N:Doe;John;;Mr.;
EMAIL;TYPE=work:[email protected]
TEL;TYPE=CELL:+15551234567
END:VCARD

Output (pretty-printed, structured):

[
  {
    "version": "3.0",
    "fn": "John Doe",
    "name": { "family": "Doe", "given": "John", "middle": "", "prefix": "Mr.", "suffix": "" },
    "emails": [ { "value": "[email protected]", "types": ["work"] } ],
    "phones": [ { "value": "+15551234567", "types": ["cell"] } ]
  }
]

Repeatable properties (EMAIL, TEL, URL, ADR) collect into arrays, and each one keeps its TYPE tags (lower-cased) in a types array — so a phone marked TYPE=CELL,voice or the vCard 2.1 bare form TEL;WORK;VOICE: both come through as "types": ["cell", "voice"].

Options

• Split Name and Address into fields (structured, default on) — the N property becomes { family, given, middle, prefix, suffix } and each ADR becomes { poBox, extended, street, locality, region, postalCode, country }. Turn it off to keep N/ADR as their raw semicolon-joined strings.
• Output shape (wrap) — array returns a bare JSON array of contact objects; object returns { "contacts": [...], "count": N } so you have the total without counting.
• Pretty-print (pretty, default off) — indent the JSON for reading; leave it off for compact single-line output.

Limits & edge cases

• Known properties (FN, N, NICKNAME, ORG, TITLE, ROLE, BDAY, NOTE, EMAIL, TEL, URL, ADR) get dedicated keys; any other property is preserved under an other array as { property, value, types }, so nothing is silently dropped.
• Singular properties keep the first occurrence if a card repeats them.
• Input must contain at least one BEGIN:VCARD … END:VCARD block; text with no card returns an error rather than an empty result.
• BDAY and other dates are returned as their original string — no reformatting.
• Everything is held in memory in your browser, so very large exports are bounded by available RAM rather than a fixed contact cap.

FAQ