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

Convert a vCard (.vcf) contacts export from an iPhone, an Android phone, Gmail or Outlook into CSV, one row per contact. vCard 2.1, 3.0 and 4.0 are read, including folded lines, quoted-printable values, group prefixes such as item1.TEL, and bare 2.1 parameters such as TEL;WORK;VOICE. The first email and phone fill their own columns while every value is also listed with its type in the emails and phones columns. A photo is never written into the spreadsheet: PHOTO, LOGO, SOUND and KEY values are dropped and counted. The browser page accepts a 10 MB file; the API and MCP surfaces cap a request at 1 MB, so a large address book belongs on the page.

- 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/vcf-to-csv/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/vcf-to-csv/
- Same tool on the other surface: https://findutils.com/mcp/vcf-to-csv/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/vcf-to-csv/execute \
  -H "Content-Type: application/json" \
  -d '{
    "input": "BEGIN:VCARD\nVERSION:3.0\nN:Doe;John;;;\nFN:John Doe\nORG:Acme Inc.\nEMAIL;TYPE=WORK:john@acme.example\nTEL;TYPE=CELL:+15551234\nEND:VCARD\n"
  }'

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

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `input` | string | yes | The .vcf file contents. |
| `delimiter` | string | no | Output field separator. Default: a comma. Default: `","`. |

Example arguments (verified):

```json
{
  "input": "BEGIN:VCARD\nVERSION:3.0\nN:Doe;John;;;\nFN:John Doe\nORG:Acme Inc.\nEMAIL;TYPE=WORK:john@acme.example\nTEL;TYPE=CELL:+15551234\nEND:VCARD\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:vcf_to_csv`. Full MCP reference: https://findutils.com/mcp/vcf-to-csv/

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