playbooks

home / mcp / pyapple mcp tools mcp server

PyApple MCP Tools MCP Server

Provides MCP-based access to Apple apps via Python for messages, notes, contacts, mail, reminders, calendar, web search, and maps.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "54yyyu-pyapple-mcp": {
      "command": "pyapple-mcp",
      "args": []
    }
  }
}

You can extend your macOS apps with PyApple MCP Tools, a Python-based MCP server that lets you access Messages, Notes, Contacts, Mail, Reminders, Calendar, Web Search, and Maps through the Model Context Protocol. It enables seamless automation and scripting across Apple apps from a single MCP server.

How to use

You run the MCP server locally and connect an MCP client to it. Once the server is running you can issue natural language prompts to perform actions like sending a message, listing notes, searching contacts, managing emails, creating reminders, scheduling calendar events, performing web searches, or getting directions. Most commands trigger specific integrations that talk to the corresponding Apple apps, allowing you to chain actions together for multi-step workflows. Use plain language queries such as asking to send a message to someone, locate a note about a topic, or fetch calendar entries for the week.

How to install

Prerequisites: macOS 10.15+ and Python 3.10+. You may need appropriate permissions to access Contacts, Calendar, Messages, Mail, Notes, Reminders, and Automation.

Automated setup (recommended) to configure Claude Desktop for PyApple MCP Tools:

pip install pyapple-mcp

pyapple-mcp-setup

Manual installation

Install the package, then configure Claude Desktop to load the MCP server.

Install the package:

pip install pyapple-mcp

Configure Claude Desktop by editing the configuration file to include the MCP server entry:

{
  "mcpServers": {
    "pyapple": {
      "command": "pyapple-mcp"
    }
  }
}

Restart Claude Desktop to load the new configuration.

Available tools

messages

Send and read messages using the Apple Messages app.

notes

List, search, create, and delete notes in Apple Notes.

contacts

Search contacts in Apple Contacts.

mail

Send emails, search messages, and manage mail with Apple Mail.

reminders

List, search, and create reminders in Apple Reminders.

calendar

Search events, create calendar entries, and manage your schedule.

websearch

Search the web using DuckDuckGo.

maps

Search locations, get directions, and manage guides with Apple Maps.