Integrations
Provides tools for interacting with various Apple applications including Contacts, Notes, Messages, Mail, Reminders, Calendar, and Maps, allowing users to search, create, and manage content within these native macOS applications.
Allows web searches using DuckDuckGo's search engine and retrieval of content from search results.
Enables integration with macOS applications and services, providing access to system features through AppleScript for managing personal information and communication.
Apple MCP (Model Context Protocol) Tools
A collection of tools that allow AI assistants like Claude to interact with Apple applications and services through the Model Context Protocol (MCP).
Overview
This package provides MCP tools for interacting with various Apple applications and services, including:
- Contacts: Search and retrieve contacts from Apple Contacts app
- Notes: Search, retrieve, create notes, and list folders in Apple Notes app
- Messages: Send, read, schedule messages and check unread messages
- Mail: Read unread emails, search emails, and send emails
- Reminders: Search, create, and open reminders in Apple Reminders app
- Calendar: Search, create, and open calendar events in Apple Calendar app
- Maps: Search locations, manage guides, save favorites, and get directions
- Web Search: Search the web using DuckDuckGo and retrieve content from search results
Installation
Requirements
- macOS operating system
- Node.js 18+ or Bun runtime
- Appropriate permissions for accessing Apple applications (Contacts, Notes, Messages, Mail, etc.)
Usage
Starting the MCP Server
Connecting to Claude
To use these tools with Claude, you'll need to connect the MCP server to Claude. This can be done using the MCP proxy or directly through Claude's interface if available.
Tool Examples
Contacts
Notes
Messages
Reminders
Calendar
Maps
Web Search
Architecture
The Apple MCP tool is built with a modular architecture:
- index.ts: Main entry point that sets up the MCP server and registers tools
- tools.ts: Defines the tool schemas and descriptions
- src/handlers/: Contains handler functions for each tool
- src/scripts/: Contains AppleScript scripts for interacting with Apple applications
- utils/: Contains utility modules for each Apple service
The tool uses lazy loading to improve performance, only loading modules when they are needed.
Security and Permissions
This tool requires access to various Apple applications and services. You will need to grant permissions when prompted by macOS. These permissions can be managed in System Preferences > Security & Privacy > Privacy.
Development
Setup
Running in Development Mode
Code Style
- Use 2-space indentation
- Keep lines under 100 characters
- Use explicit type annotations for function parameters and returns
- Follow PascalCase for types, interfaces, and Tool constants
- Use camelCase for variables and functions
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
You must be authenticated.
A 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.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables semantic search and retrieval of Apple Notes content, allowing AI assistants to access, search, and create notes using on-device embeddings.Last updated -TypeScript
- -securityFlicense-qualityA versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.Last updated -2Python
- -securityFlicense-qualityA Model Context Protocol server that enables semantic search and RAG over your Apple Notes, allowing AI assistants like Claude to search and reference your notes during conversations.Last updated -6TypeScript
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to interact with Apple Reminders on macOS, allowing users to view lists, retrieve, create, complete, and delete reminders through natural language.Last updated -TypeScript