Can I look up a contact by name instead of ID?

Yes. get_contact accepts either a name or a contact ID. Just ask in plain language, like "get me Sofia Martinez's details," and the AI matches it against your Contacts app.

Does get_contact upload my contacts to the cloud?

No. The lookup runs entirely on your Mac through LMCP. Only the single card you asked about is read, and nothing is stored on a server or used for training.

What info does get_contact return?

It returns the fields on the contact card — phone numbers, email addresses, company, and notes — exactly as they appear in Contacts.app, including data synced from iCloud, Gmail or Exchange.

Which AI assistants can use get_contact?

Claude Desktop, Cursor, VS Code, Windsurf and Zed connect locally via stdio, while ChatGPT, Claude.ai, Grok and Perplexity connect through the LMCP Cloud Relay connector.

Get a Mac Contact by Name with AI (get_contact)

The get_contact tool lets your AI assistant fetch a single contact straight from your Mac's Contacts app (Contacts.app), looked up by name or by contact ID. Instead of you opening Contacts and scrolling, you just ask in plain language. For example, you type: "What's Sofia Martinez's mobile number and email?" and the AI returns her phone numbers, email addresses, company, and any notes on the card — read directly from your real address book.

Because LMCP runs natively on macOS, the lookup happens on your machine. No address book gets uploaded anywhere, and no third-party API sits between the AI and your contacts. Download LMCP to enable it.

Which AI agents work?

get_contact works across every major MCP-capable AI client:

Desktop clients — Claude Desktop, Cursor, VS Code (GitHub Copilot), Windsurf and Zed auto-configure through a local stdio connection, so the tool appears as soon as you restart the app.
Web AIs — ChatGPT, Claude.ai (web), Grok and Perplexity connect through the LMCP Cloud Relay connector, which securely bridges the web assistant to the server running on your Mac.

The same get_contact tool — one of 150+ tools LMCP exposes — is available in all of them.

Automation

get_contact becomes powerful when chained with other LMCP tools. The AI can resolve a name with get_contact, then hand the email address to send_email, the phone number to send_message (Messages/WhatsApp), or the company field into a create_calendar_event invite. A prompt like "Find Daniel's email and send him the Q3 deck" runs get_contact first, then the email tool — no copy-pasting between apps.

Context

Unlike a generic chatbot that knows nothing about you, LMCP gives the AI access to your real Mac data. get_contact reads your actual Contacts cards — the same ones synced across iCloud, Gmail, or Exchange accounts on your Mac. So the AI works with the people you actually know, with their current numbers and addresses, not a guess or a stale snapshot.

Productivity

Looking up a contact, copying a number, and pasting it into a message is a small task you do dozens of times a week. get_contact collapses that into a single sentence. Combined with the email and messaging tools, drafting a personalized message to someone in your address book goes from a minute of app-switching to a few seconds of conversation. For anyone juggling a large network — recruiters, founders, sales — that compounds fast.

Privacy & GDPR

Everything get_contact does happens locally on your Mac. Your contacts are never copied to a cloud server, never logged remotely, and never used to train any model. The AI only sees the specific card you asked about, and only for as long as it takes to answer. This is privacy by architecture, not by policy — read more about how LMCP is GDPR-compliant by architecture. macOS still gates Contacts access behind its own permission prompt, so you stay in control of when the tool can read your address book.