contactsLABSCO SUMMARY
Working through the apps rather than the cloud APIs is why this reaches things the official integrations cannot.
iMessage has no public API; Notes has no useful one. Driving the applications is the only route to that data, and it is the reason this exists. The same fact sets the boundary: it only works on the Mac it runs on, and it can send messages and mail as you. That is a lot of authority sitting on your own machine — appropriate for a personal assistant, worth thinking about before it runs unattended.
What it is
A Python implementation of tools over Apple's own applications, so an assistant works with what is already on your Mac rather than a cloud copy of it.
What you get
- Messages — send and read
- Notes — list, search, create, delete
- Mail — send, search, manage
- Reminders and Calendar — list, search, create
- Contacts search, Maps, and web search
Requirements
macOS, since it drives the native applications. Python, installed from PyPI. MIT licensed.
Setup effort
One command — pip install pyapple-mcp
USE CASES
01
Working with iMessage
Read and send, which no cloud API offers.
02
Searching your own notes
Apple Notes, in place.
03
Managing the day
Reminders and Calendar together.
10 tools
Listed in project docs. Your client may show a different list.
notesmessagesmailreminderscalendarmapsshortcutspresencedoctorBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation.
Requires
pyapple-mcp on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install pyapple-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"pyapple": {
"command": "pyapple-mcp"
}
}
}
