AppleMCP

Native macOS 15+ MCP server that gives AI assistants secure, read-only access to your local Apple data and Apple Intelligence features.

AppleMCP consists of a SwiftUI app that bridges macOS privacy-controlled APIs and a stdio MCP server for Claude Desktop, Claude Code, and other MCP clients. Everything runs locally — no cloud, no sync, no data leaves your machine.

What It Does

Source Access Method Permission
Mail Local Envelope Index (SQLite) + .emlx body parsing, AppleScript fallback Full Disk Access or Mail Automation
Calendar EventKit Calendar Access
Contacts Contacts.framework Contacts Access
Reminders EventKit Reminders Access
Notes Notes.app AppleScript Automation Automation Permission
Photos Photos.framework Photos Access
Apple Intelligence Native APIs (ImagePlayground, Translation, Writing Tools) None

Quick Start

1. Build

swift build

2. Run the App

./script/build_and_run.sh

The app opens a macOS window and starts a local HTTP endpoint on 127.0.0.1:47651. Click Permissions on first launch to grant macOS access to Calendar, Contacts, Reminders, Photos, and Notes.

3. Connect Your MCP Client

Claude Desktop

Add to your Claude Desktop MCP config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "applemcp": {
      "command": "/path/to/AppleMCP/.build/debug/M3MCPBridge"
    }
  }
}

Claude Code

claude mcp add applemcp /path/to/AppleMCP/.build/debug/M3MCPBridge

The M3MCP UI app must be running for MCP calls to work. The bridge communicates with the app over a local loopback HTTP connection.

MCP Tools

Data Access

Tool Description
mail_search Search messages in Apple Mail (subject, sender, date, read status)
mail_read Read full email content by ID (body, recipients, attachments metadata)
calendar_search Search calendar events via EventKit
contacts_search Search contacts / address book
reminders_search Search reminders (incomplete, completed, or all)
notes_search Search Apple Notes by keyword
notes_read Read a single note by ID
photos_search Search Apple Photos library metadata
photos_albums List photo albums with counts

Apple Intelligence

Tool Description
ai_writing_tools Summarize, rewrite, proofread, or change tone of text
ai_translate Translate text using Apple system translation
ai_image_playground Generate images from text descriptions (macOS 15.4+)

System

Tool Description
source_status List available providers and their states
permissions_status Report macOS permission state for all providers
permissions_request Request all required macOS permissions
permissions_open_settings Open System Settings for permission remediation

Architecture

MCP Client (Claude) <--stdio--> M3MCPBridge <--HTTP 127.0.0.1:47651--> M3MCPApp (SwiftUI)
                                                                            |
                                                      EventKit / Contacts / Photos / Mail Index / AppleScript
  • M3MCPApp — SwiftUI app with macOS TCC permissions, provides the actual data access
  • M3MCPBridge — Lightweight stdio MCP server that translates MCP protocol to HTTP calls
  • M3MCPCore — Shared models and types

Privacy

All data stays local. The app uses macOS TCC (Transparency, Consent, and Control) for every data source. No network requests are made except to 127.0.0.1. Mail reads the local SQLite index directly — it never sends emails or modifies any data.

Requirements

  • macOS 15.0+
  • Swift 5.9+
  • Apple Intelligence features require macOS 15.4+ with Apple Silicon

License

MIT