# vCard Contacts Parser MCP for AI Agents AI Agent Connect

> vCard Contacts Parser turns massive iPhone and Android .vcf contact exports into structured JSON. It turns your AI into a hyper-intelligent local address book without uploading your personal data to the cloud.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_5mEeS0qNVpmG768vVHGGq39nmUIHtKvo4gqOxt1n/ai-agent-connect
- **Tags:** vcard, contact-management, data-parsing, json-conversion, local-processing

## Description

When you export your phone's address book, you get a bloated file. These files are often packed with base64-encoded profile pictures and legacy formatting that break most AI models. If you try to feed that raw file to an LLM, it will likely hit a context limit or start hallucinating phone numbers because it cannot parse the binary noise. You end up with an AI that gives you incorrect information or refuses to work at all because the file is too large.

This MCP acts as a dedicated contact intelligence engine. It runs locally on your machine, stripping away the junk and turning the raw format into a clean JSON array. Your AI gets exactly what it needs: names, organizations, phones, and emails. It is one of the reasons why Vinkius makes managing these types of complex data connections so much easier. Your personal phonebook stays on your hardware, and you get perfect extraction of country codes and company roles. You can process files with over 5,000 contacts instantly, making it easy to query your entire network without the usual headaches. It removes the need for manual cleaning and ensures that your agent sees only the most relevant data points. Because it works locally, your data never leaves your device. You get a private, high-speed way to turn a messy export into a structured database that your AI can actually use to help you find people, verify numbers, and organize your professional network.

## Tools

### parse_travel_itinerary
Parse travel itinerary text into organized segments. This tool identifies flights, hotel check-ins, and meals from raw text.

## Prompt Examples

**Prompt:** 
```
Search my contacts.vcf and give me a list of everyone who works at 'Vinkius'.
```

**Response:** 
```
I found 3 contacts working at Vinkius:

| Name | Role |
| :--- | :--- |
| **John Silva** | DevOps |
| **Sarah Connor** | Design |
| **Mike Ross** | Legal |
```

**Prompt:** 
```
Extract all the email addresses from this vCard export and format them as a CSV.
```

**Response:** 
```
I've extracted the emails from your vCard file:

Name,Email
Alice Smith,alice@example.com
Bob Jones,bob@example.org
```

**Prompt:** 
```
Look through my contacts and find the phone number for 'Plumber'.
```

**Response:** 
```
The phone number saved under **Plumber** is +1 (555) 019-8372.
```

## Capabilities

### Strip binary noise from vCards
It removes images and bloated headers so the AI only sees the text it needs.

### Convert large exports to JSON
Turn thousands of contacts into a format the AI can actually read in one go.

### Keep data 100% local
Your contacts stay on your machine and never touch the cloud.

### Extract country codes and roles
It pulls out specific details like company titles and international prefixes automatically.

### Query contacts via natural language
Ask your agent to find a specific person or company and get the info instantly.

## Use Cases

### Finding a specific lead in a huge export
A sales rep has a 3,000-contact export and asks their agent, 'Who is the best point of contact at Acme Corp?' The AI finds the number instantly.

### Extracting emails for a newsletter
You ask your agent to pull all email addresses from a vCard file and format them into a clean list for a mailing campaign.

### Privacy-first contact searching
A user wants to use an AI to find a plumber in their contacts but refuses to upload their phonebook to the cloud. This Connector keeps it local.

### Organizing professional roles
You ask your agent to list everyone in your contacts who works in a 'Design' role, and it pulls that data from the parsed JSON.

## Benefits

- Keep your personal data private because the Connector runs 100% locally on your machine.
- Stop hallucinating phone numbers by using the clean JSON output to give your agent perfect accuracy.
- Handle massive files with over 5,000 contacts without hitting context window limits.
- Get instant answers to questions about company roles and organization titles.
- Save time by skipping the manual process of cleaning up messy .vcf files before use.
- Maintain a high-speed workflow for searching your entire professional network.

## How It Works

The bottom line is it turns messy phone exports into a searchable database for your AI.

1. Point your AI client at a local .vcf file.
2. The Connector parses the raw data and strips out the junk locally.
3. Your AI returns the specific contact info or a clean list of results.

## Frequently Asked Questions

**Can I use vCard Contacts Parser with my iPhone contact export?**
Yes. It is designed to handle the standard .vcf files you get when you export your contacts from an iPhone or Android device.

**Does vCard Contacts Parser send my personal data to the cloud?**
No. This Connector runs 100% locally on your machine. Your phonebook never leaves your hardware, ensuring your privacy stays intact.

**How many contacts can vCard Contacts Parser handle at once?**
It can process massive files containing over 5,000 contacts instantly, making it much more capable than standard copy-paste methods.

**Will vCard Contacts Parser help me find specific jobs or roles?**
Yes. It extracts organization details and roles, so you can ask your AI to find people based on their job titles or companies.

**Can I use vCard Contacts Parser to find a specific person's phone number?**
Absolutely. Once the file is parsed, you can just ask your AI agent for a specific name or role, and it will pull the number for you.

**Is my address book uploaded to the cloud?**
Never. The vCard parsing is executed completely local on your device. Only the extracted text representation is provided to the AI context.

**Does it support multiple contacts in a single file?**
Yes! It perfectly parses multi-vCard files exported from iOS, Google Contacts, or Android devices, handling thousands of entries seamlessly.

**What happens to the contact profile pictures?**
Profile pictures (PHOTO;ENCODING=b) are intentionally ignored and stripped during parsing to preserve AI context tokens and prevent crashes.