# Rapport vCard Converter

> Convert vCards (.vcf) to a contacts CSV and back: vCard 2.1, 3.0 and 4.0. Turns a .vcf file with one or many contact cards into a clean CSV with first name, last name, e-mail, phone, company, job title, address and tags — or a contacts CSV (Rapport, HubSpot, Pipedrive, Outlook-style headers) into vCards. Folded lines, escaped commas and old QUOTED-PRINTABLE phone exports are handled. Same converter as Rapport’s vCard import and export.

Part of usefulweb.app (https://usefulweb.app/). Part of [Rapport](https://rapport.usefulweb.app/) (ownerApp: rapport). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://rapportvcardconvert.usefulweb.app/ (interactive tool at https://rapportvcardconvert.usefulweb.app/tool)
- JSON API: POST https://rapportvcardconvert.usefulweb.app/api/v1/calculate with a JSON object of inputs (schema: https://rapportvcardconvert.usefulweb.app/api/v1/tool)
- OpenAPI: https://rapportvcardconvert.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://rapportvcardconvert.usefulweb.app/mcp - tool `rapport_vcard_convert`

## Inputs
- text (textarea): vCards or contacts CSV - Paste vCards (BEGIN:VCARD … END:VCARD) to get a CSV, or a CSV with a header row to get vCards.
- file (file): File (optional) - Used instead of the pasted text when given.
- version (select): vCard version to write

## Method
- vCards are unfolded first (a line break followed by a space or tab continues the line), then split into properties; group prefixes (item1.EMAIL) are ignored and TYPE parameters choose the preferred e-mail, phone and address (PREF first, then work).
- N gives last and first name; when it is missing, FN is split at the last space. ORG gives the company, ADR is joined into one address line (street, postal code + city, region, country). Values are unescaped (\n, \, and \;). vCard 2.1 QUOTED-PRINTABLE values are decoded as UTF-8 (or Windows-1252 when the card says so).
- CSV columns are recognised by their header names: Rapport’s own export, HubSpot and Pipedrive exports and common English and German names (Vorname, Nachname, Firma …). The CSV is RFC 4180 with comma, semicolon or tab.
- vCards are written with CRLF line ends and folded at 75 octets without splitting a UTF-8 character; text is escaped. vCard 4.0 phones are written as tel: URIs.