
Contactsmcp
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 toolsPublic 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.
Details
- Repository
- github.com/aernouddekker/macos-mcp
- Categories
- Sales & Marketing, Productivity & Office
- Package
@aernoud/contactsmcp- Transport
- STDIO
- Registry
- MCP registry, active