Contactsmcp
Wire your coding agent to macOS Contacts.app so you can look up, add, and edit people while you ship outreach or support workflows from the terminal.
Overview
Contacts MCP is a Build-phase MCP server that lets coding agents manage macOS Contacts.app entries through AppleScript over stdio.
What is this MCP server?
- Bridges Claude and other MCP clients to macOS Contacts.app through AppleScript
- Published on npm as @aernoud/contactsmcp (v0.4.0) with stdio transport
- macOS-only: requires Contacts.app and automation privacy approvals
- Part of the aernouddekker/macos-mcp family on GitHub
- MCP integration for local contact data, not a hosted address-book API
- Server version 0.4.0
- npm package @aernoud/contactsmcp
- stdio MCP transport
Community signal: 3 GitHub stars.
What problem does it solve?
Switching out of Claude Code to copy contact details from Contacts.app breaks flow when you are drafting outreach, support replies, or beta invites.
Who is it for?
Solo Mac builders using Claude Code who keep leads and collaborators in Contacts.app and want agent-driven lookup and edits.
Skip if: Windows or Linux developers, teams on Google Workspace CRM, or anyone who cannot grant macOS Automation permissions to Contacts.
What do I get? / Deliverables
After you register the server, your agent can query and update local contacts in conversation without manual app switching.
- MCP-configured access to search and mutate Contacts.app records from the agent
- Repeatable local contact lookups without leaving the coding session
Recommended MCP Servers
Journey fit
Canonical shelf is Build because registering an MCP server is product wiring—giving the agent a new tool surface—not a one-off launch or growth campaign. Integrations is the right subphase: this server exposes Contacts.app over MCP/stdio rather than replacing Mail, CRM, or spreadsheet logic.
How it compares
Native macOS Contacts bridge via MCP, not a cloud CRM or marketing automation platform.
Common Questions / FAQ
Who is Contacts MCP for?
It is for indie and solo builders on macOS who use MCP-enabled agents and store people in Contacts.app instead of a separate CRM.
When should I use Contacts MCP?
Use it during Build or day-to-day Operate tasks when you need the agent to resolve names, emails, or phone numbers from your local address book while you code or draft comms.
How do I add Contacts MCP to my agent?
Install @aernoud/contactsmcp from npm, add a stdio MCP entry pointing at the package in Claude Desktop or Claude Code, and allow Contacts automation when macOS prompts you.