Contactsmcp MCP server

by aernouddekker·io.github.aernouddekker/contactsmcp·v0.4.0·5 stars

No reviews yet

MCP server for macOS Contacts.app — contact management via AppleScript

A92/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A92/100

full report

Adoption

Growing

5 stars25 downloads/wk

Reviews

Write one

Nobody has reviewed Contactsmcp yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Contactsmcp tools (15, 6 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

add-to-group
Add a contact to a group in macOS Contacts.app
create-contactwrite action
Create a new contact in macOS Contacts.app
create-groupwrite action
Create a new contact group in macOS Contacts.app
delete-contactwrite action
Delete a contact from macOS Contacts.app
delete-groupwrite action
Delete a contact group from macOS Contacts.app
get-my-card
Get the user's own contact card from macOS Contacts.app
get-vcard
Get the vCard 3.0 text for a contact by their Contacts.app ID
list-group-members
List all contacts in a group in macOS Contacts.app
list-groups
List all contact groups in macOS Contacts.app with member counts
read-contact
Get full details of a contact by their Contacts.app ID
remove-from-groupwrite action
Remove a contact from a group in macOS Contacts.app
rename-group
Rename a contact group in macOS Contacts.app
search-by-modification-date
Find contacts modified after a given date in macOS Contacts.app
search-contacts
Search contacts in macOS Contacts.app by name, email, or phone number
update-contactwrite action
Update fields on an existing contact in macOS Contacts.app

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan37 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 25 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Contactsmcp compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 92/100; higher than 93% of 48,243 servers
Tools: 15; the typical server has 7
Tools that change things: 40%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 5; more than 83% of 28,706 servers
Downloads a week: 25; more than 11% of 12,306 servers with a package

What its tools let an agent do: 7 read · 3 create · 2 change · 3 delete

Install Contactsmcp in Claude Code, Cursor or VS Code

Runs npx -y @aernoud/contactsmcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add contactsmcp -- npx -y @aernoud/contactsmcp

Add to Cursor

What the publisher says

From the Contactsmcp repository's README, as published. We do not edit it. Read it on GitHub

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.

Numbers (numbersmcp) — 29 tools

Works with any open Numbers spreadsheet.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Contactsmcp: common questions

Is Contactsmcp MCP server safe?: Yes, by our scan: it is graded A (92/100). Read the Contactsmcp safety report
How do I install Contactsmcp?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Contactsmcp need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Contactsmcp maintained?: The last commit was 64 days ago (2026-09-02). The latest release is v0.4.0.
How does Contactsmcp compare with other MCP servers?: safety score 92/100 (higher than 93% of 48,243 servers); tools 15 (the typical server has 7); tools that change things 40% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.