Rapport vCard Converter
Convert vCards (.vcf) to a contacts CSV and back: vCard 2.1, 3.0 and 4.0.
How it works
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.
- 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.
Sources
Part of Rapport
-
Rapport CRM
A CRM for contacts, companies, deals and quotes — local-first, shared with your team.
How to convert vCards to CSV and back
Turn .vcf files from a phone or address book into a clean contacts CSV, or a spreadsheet or CRM export into vCard 4.0 or 3.0 files you can import anywhere.
What it is for
vCard (.vcf) is the format phones, Outlook, Apple Contacts and Google Contacts use to exchange contacts. Spreadsheets and CRMs prefer CSV. This tool converts in both directions: paste vCards and you get a CSV with one row per person, paste a CSV with a header row and you get vCards. It reads vCard 2.1, 3.0 and 4.0, including the awkward parts — folded long lines, escaped commas and the quoted-printable umlauts old phones write — and recognises the column names of Rapport's own export, HubSpot and Pipedrive exports and common English and German headers.
It is the same code Rapport uses for File → Import vCards… and Download vCard, so a file that converts cleanly here imports cleanly there.
Worked example
The first example pastes three cards that each use a different version: Camille Rousseau as vCard 4.0 with a work address and two categories, Tobias Krüger as vCard 3.0 with a note folded over two lines, and Jürgen Müller as vCard 2.1 with his name in quoted-printable (J=C3=BCrgen M=C3=BCller).
Converted 3 vCards to CSV.
The metrics show Contacts 3, Direction vCard → CSV and vCard versions read 2.1, 3.0, 4.0. The table lists Camille with her address joined into one line (12 rue de la République, 69002 Lyon, FR), Tobias with his mobile number and Jürgen with his umlauts restored. You can download contacts.csv and, as a check, contacts.vcf written back out.
The other way round: a German address list with semicolons and the headers Vorname; Nachname; Firma; E-Mail; Telefon; Position, two rows (Jürgen Müller at Bäckerei Müller GmbH as Inhaber, and Ayşe Yılmaz without a company), with vCard 4.0 chosen:
Converted 2 CSV contacts to vCards.
Both people appear in the table with name, e-mail, phone and company; the download contacts.vcf holds two cards that any phone imports.
How to read the result
- Contacts — how many people were found. Compare it with the number of cards or rows you expected.
- Direction — the tool decides from the text:
BEGIN:VCARDmeans vCard → CSV, anything else is treated as CSV. - vCard versions read — mixed files are fine; each card is read by its own rules.
- Contacts table — a preview with name, e-mail, phone, company, job title and address. Further e-mails and phones are kept in the files.
- Downloads — the converted file and the same contacts in the other format.
Tips and common mistakes
- Choose vCard 3.0 when the file goes to older software or some car kits; 4.0 is the current standard and writes phone numbers as
tel:links. - A CSV needs a header row. Columns the tool does not recognise are ignored, so rename odd headers such as Mobil privat to Phone first.
- Commas, semicolons and tabs as separators are all detected; quoted cells may contain line breaks.
- When a card has several e-mails or phones, the one marked as preferred (or work) goes first in the CSV.
- Photos and custom
X-fields are not carried over.
FAQ
My phone exported one .vcf file with hundreds of contacts — is that a problem?
No. Paste the whole file or upload it; every BEGIN:VCARD … END:VCARD block becomes one row.
Why does the name look wrong for some cards?
Cards without the structured N field only have the display name FN; the tool then splits it at the last space, which fails for names like Maria de la Cruz. Check those rows.
Are my contacts uploaded somewhere?
They are processed for this one conversion and not stored. In Rapport, the same conversion runs in your browser.
Can I import the result into Rapport directly?
Yes — use File → Import vCards… or File → Import CSV…; Rapport also finds duplicates afterwards.
Guide last updated:
For scripts and AI agents
- JSON API:
POST https://rapportvcardconvert.usefulweb.app/api/v1/calculate(same calculation as this page) - Interface description: OpenAPI 3.1 · AI guide: llms.txt
- MCP server (Streamable HTTP):
https://rapportvcardconvert.usefulweb.app/mcp· tool namerapport_vcard_convert
Example request
curl -s -X POST https://rapportvcardconvert.usefulweb.app/api/v1/calculate \
-H 'content-type: application/json' \
-d '{…see OpenAPI examples…}'