aernouddekker avatar

Contactsmcp

aernouddekker/macos-mcp

Bridges Claude to macOS Contacts.app via AppleScript, giving you 15 tools to read, write, and organize your system address book without leaving the terminal. Search by name, email, phone, or modification date. Create, update, and delete contacts. Manage groups: create them, rename them, add or remove members. Export contacts as vCard 3.0. Grab your own "me" card programmatically. Works with every account synced to Contacts.app, whether iCloud, Exchange, CardDAV, or local. No API keys, no OAuth, no network calls. Just direct access to the same contact database the OS uses. Useful when you're scripting workflows that need to look up phone numbers, validate email addresses, or bulk-tag contacts into groups.

tools
15
transport
STDIO
last updated
Jun 2, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

search-contactsSearch contacts by name, email, or phone

Search contacts by name, email, or phone

No parameter schema in public metadata yet.

search-by-modification-dateFind contacts modified after a given date

Find contacts modified after a given date

No parameter schema in public metadata yet.

read-contactGet full contact details

Get full contact details

No parameter schema in public metadata yet.

get-my-cardGet the user's own contact card

Get the user's own contact card

No parameter schema in public metadata yet.

get-vcardExport a contact as vCard 3.0 text

Export a contact as vCard 3.0 text

No parameter schema in public metadata yet.

create-contactCreate a new contact

Create a new contact

No parameter schema in public metadata yet.

update-contactUpdate contact fields

Update contact fields

No parameter schema in public metadata yet.

delete-contactDelete a contact

Delete a contact

No parameter schema in public metadata yet.

list-groupsList all contact groups

List all contact groups

No parameter schema in public metadata yet.

create-groupCreate a new contact group

Create a new contact group

No parameter schema in public metadata yet.

rename-groupRename a contact group

Rename a contact group

No parameter schema in public metadata yet.

delete-groupDelete a contact group

Delete a contact group

No parameter schema in public metadata yet.

add-to-groupAdd a contact to a group

Add a contact to a group

No parameter schema in public metadata yet.

remove-from-groupRemove a contact from a group

Remove a contact from a group

No parameter schema in public metadata yet.

list-group-membersList all contacts in a group

List all contacts in a group

No parameter schema in public metadata yet.

Sponsors

Readme

macos-mcp

MCP servers for macOS native apps — gives Claude Code, Claude Desktop, and any MCP client native access to Mail, Numbers, Contacts, Calendar, Reminders, and FaceTime / phone calls.

No API keys, no OAuth, no cloud services. Talks directly to macOS apps via AppleScript and URL schemes (tel://, facetime://). Runs locally on your Mac.

CUPS printing (printmcp) used to live here; it moved to office-mcp since it's a shell wrapper, not an AppleScript bridge.

Servers

Mail (mailappmcp) — 21 tools

Works with every email account configured in Mail.app — iCloud, Gmail, Outlook, Fastmail, you name it.


View the full README on GitHub

Details

Repository
github.com/aernouddekker/macos-mcp
Categories
Sales & Marketing, Productivity & Office
Package
@aernoud/contactsmcp
Transport
STDIO
Registry
MCP registry, active

More from aernouddekker

Related Sales & Marketing MCP servers

View all
1sequenzy avatarSequenzy MCPsequenzy/mcpSequenzy MCP server for AI-powered email marketing automation.0stars
2localseodata avatarMcp Serverlocalseodata/mcp-server53 local SEO data tools: rankings, reviews, audits, keywords, AI visibility.0stars
3vdalhambra avatarSiteaudit Mcpvdalhambra/siteaudit-mcpSEO, performance, and security audits for any URL — no API keys required3stars
4akshaysharma1088 avatarpipeverifyakshaysharma1088/pipeverifyRead-only check that a pipeline change left the data right: pass, review or block.2stars
5zafety-vibin avatarGrimoire for Gamemasterszafety-vibin/grimoire-mcpD&D and TTRPG campaign manager for GMs: your AI reads and writes a live, typed campaign database.2stars
6cyanheads avatarOpenfec Mcp Servercyanheads/openfec-mcp-serverAccess FEC campaign finance data. Query data about candidates, money trails, and election filings.2stars