# Csv To Vcf — REST API endpoint `csv-to-vcf`

Convert a CSV of contacts into one multi-card .vcf file that iPhone, Android, Google Contacts and Outlook import. Columns are matched by name: full name or first and last name, email, phone or mobile, work and home phone, company, job title, website, notes, street, city, region, postal code, country and birthday, including the headers Google Contacts, Outlook and vcf_to_csv write; column_map overrides any match. One card per row with a name, email or phone; other rows are skipped and listed by row number. vCard 3.0 by default, 4.0 on request. Values are escaped and lines folded at 75 octets per RFC 6350. Photos are not written and nothing is uploaded or synced.

- Category: data
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/csv-to-vcf/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/csv-to-vcf/
- Same tool on the other surface: https://findutils.com/mcp/csv-to-vcf/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/csv-to-vcf/execute \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Name,Email,Phone\nJane Doe,jane@example.com,+15551234\n"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/csv-to-vcf
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `input` | string | yes | CSV text with a header row. |
| `delimiter` | string | no | Field separator. Default: detected from the header (comma, semicolon, tab or pipe). |
| `version` | string (3.0 \| 4.0) | no | vCard version. Defaults to 3.0. Default: `"3.0"`. |
| `column_map` | object | no | Header name per field when the automatic match is wrong: full_name, given_name, family_name, email, emails, phone, work_phone, home_phone, phones, organization, title, url, note, street, city, region, postal_code, country, birthday, uid. |

Example arguments (verified):

```json
{
  "input": "Name,Email,Phone\nJane Doe,jane@example.com,+15551234\n"
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:csv_to_vcf`. Full MCP reference: https://findutils.com/mcp/csv-to-vcf/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt