Vcard Generate API

POST https://api.findutils.com/api/tools/vcard-generate/execute

Generate a vCard (.vcf) contact card from name, organisation, emails, phones, address, URL, note and birthday. vCard 3.0 by default (imports into iOS Contacts, Google Contacts and Outlook), 4.0 on request. Values are escaped and long lines folded per RFC 6350.

Open the tool Try it

Request body

application/json

full_name

string required

Display name (FN). Required.
given_name

string optional

First name (N given part).
family_name

string optional

Last name (N family part).
organization

string optional

Company or organisation (ORG).
title

string optional

Job title (TITLE).
emails

array optional

Email addresses (EMAIL). The first is marked preferred.
phones

array optional

Phone numbers (TEL), international format recommended. The first is marked preferred.
street

string optional

Street address (ADR street part).
city

string optional

City (ADR locality).
region

string optional

State, province or region (ADR region).
postal_code

string optional

Postal code (ADR).
country

string optional

Country (ADR).
url

string optional

Website (URL).
note

string optional

Free text (NOTE).
birthday

string optional

Birthday as YYYY-MM-DD (BDAY).
version

string optional

vCard version. Defaults to 3.0. One of 3.0 · 4.0. Default "3.0".

Example arguments

Verified

{
  "full_name": "Ada Lovelace",
  "emails": [
    "[email protected]"
  ],
  "phones": [
    "+44 20 7946 0000"
  ]
}

curl -X POST https://api.findutils.com/api/tools/vcard-generate/execute \
  -H "Content-Type: application/json" \
  -d '{
    "full_name": "Ada Lovelace",
    "emails": [
      "[email protected]"
    ],
    "phones": [
      "+44 20 7946 0000"
    ]
  }'

const response = await fetch('https://api.findutils.com/api/tools/vcard-generate/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"full_name":"Ada Lovelace","emails":["[email protected]"],"phones":["+44 20 7946 0000"]}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/vcard-generate/execute",
    json={"full_name":"Ada Lovelace","emails":["[email protected]"],"phones":["+44 20 7946 0000"]},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/vcard-generate/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"full_name":"Ada Lovelace","emails":["[email protected]"],"phones":["+44 20 7946 0000"]}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call vcard_generate from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: vcard-generate
MCP name: vcard_generate
Category: Generators
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Generators tools

More to explore