Enables interaction with Apple's ecosystem through AppleScript, allowing access to native macOS applications and their data.
Project is hosted on GitHub and supports contribution through GitHub's pull request workflow.
Allows sending, reading, and scheduling iMessages through the Messages application, including accessing conversation history.
Provides tools for interacting with native macOS applications such as Contacts, Notes, Mail, Messages, Reminders, Calendar, and Maps.
Uses Pydantic models to provide type-safe interfaces for working with data from macOS applications.
Supports comprehensive testing of the MCP functionality with pytest, including coverage reporting.
Implemented in Python, providing a programmatic interface to macOS applications through a Python API.
Python Apple MCP (Model Context Protocol)
A Python implementation of the server that handles interactions with macOS applications such as Contacts, Notes, Mail, Messages, Reminders, Calendar, and Maps using FastMCP.
Features
- Interact with macOS native applications through AppleScript
- Asynchronous operations for better performance
- Comprehensive error handling
- Type-safe interfaces using Pydantic models
- Extensive test coverage
- Modular design for easy extension
Supported Applications
- Contacts
- Notes
- Messages
- Reminders
- Calendar
- Maps
Installation
- Clone the repository:
- Create a virtual environment:
- Install dependencies:
- Install test dependencies (optional):
Usage
Basic Example
Using Individual Modules
Testing
Run the test suite:
Run tests with coverage:
Run specific test file:
API Documentation
Contacts Module
find_contact(name: str) -> List[Contact]
: Search for contacts by nameget_all_contacts() -> List[Contact]
: Get all contactscreate_contact(name: str, phones: List[str]) -> Contact
: Create a new contact
Notes Module
find_note(query: str) -> List[Note]
: Search for notescreate_note(title: str, body: str, folder_name: str) -> Note
: Create a new noteget_all_notes() -> List[Note]
: Get all notes
Mail Module
send_email(to: str, subject: str, body: str) -> str
: Send an emailsearch_emails(query: str) -> List[Email]
: Search emailsget_unread_mails() -> List[Email]
: Get unread emails
Messages Module
send_message(to: str, content: str) -> bool
: Send an iMessageread_messages(phone_number: str) -> List[Message]
: Read messagesschedule_message(to: str, content: str, scheduled_time: str) -> Dict
: Schedule a message
Reminders Module
create_reminder(name: str, list_name: str, notes: str, due_date: str) -> Dict
: Create a remindersearch_reminders(query: str) -> List[Dict]
: Search remindersget_all_reminders() -> List[Dict]
: Get all reminders
Calendar Module
create_event(title: str, start_date: str, end_date: str, location: str, notes: str) -> Dict
: Create an eventsearch_events(query: str) -> List[Dict]
: Search eventsget_events() -> List[Dict]
: Get all events
Maps Module
search_locations(query: str) -> List[Location]
: Search for locationsget_directions(from_address: str, to_address: str, transport_type: str) -> str
: Get directionssave_location(name: str, address: str) -> Dict
: Save a location to favorites
Contributing
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Python server that enables interaction with macOS native applications (Contacts, Notes, Mail, Messages, Reminders, Calendar, and Maps) through AppleScript, featuring asynchronous operations and type-safe interfaces.
Related MCP Servers
- -securityAlicense-qualityA macOS app that provides an MCP server to your Messages, Contacts, and moreLast updated 2 days ago719MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables running AppleScript code to interact with Mac applications and system features including Notes, Calendar, Contacts, Messages, file management, and more.Last updated 2 months ago1569312JavaScriptMIT License
- AsecurityFlicenseAqualityA collection of tools that enable AI assistants to interact with Apple applications and services including Contacts, Notes, Messages, Mail, Reminders, Calendar, Maps, and Web Search through the Model Context Protocol.Last updated 3 months ago8TypeScript
- AsecurityAlicenseAqualityProvides a Model Context Protocol server for executing AppleScript and JavaScript for Automation scripts on macOS, featuring a knowledge base of pre-defined scripts and supporting automation of macOS applications and system functions.Last updated 5 days ago2566397TypeScriptMIT License
Appeared in Searches
- A server for file search, project analysis, and code refactoring on macOS
- Developing a versatile MCP server for analyzing project workflows in Windsurf
- Guide to Creating Google Calendar Events
- A platform for managing events and scheduling using Google Calendar
- Integrating external website forms and location data into an enquiry management app