AppleMCP

Native macOS MCP server that gives AI assistants secure, local access to your Apple data and Apple Intelligence.

macOS 15+ Swift MCP Protocol Local-first Privacy-safe

Data Sources

Mail

Search and read emails from the local Mail index. Full body, sender, recipients, dates. AppleScript fallback when Full Disk Access is unavailable.

Calendar

Search events via EventKit. Titles, locations, times, notes, all-day status, and calendar membership.

Contacts

Search your address book via Contacts.framework. Names, emails, phone numbers, addresses.

Notes

Search and read Apple Notes via Automation. Full note content, folder structure, modification dates.

Reminders

Search reminders via EventKit. Filter by completion status, due dates, priorities.

Photos

Search Photos library metadata via Photos.framework. Albums, media types, dimensions, dates.

Apple Intelligence

Writing Tools

Summarize, rewrite, proofread, or change tone using Apple's on-device writing tools.

Translation

Translate text between languages using the system translation service.

Image Playground

Generate images from text via the native ImagePlayground API. No app launch, pure API.

Architecture

Claude / AI Assistant | stdio (MCP protocol) | M3MCPBridge (lightweight CLI) | HTTP 127.0.0.1:47651 | M3MCPApp (SwiftUI, holds TCC permissions) | EventKit / Contacts / Photos / Mail Index / AppleScript

Setup

# Build
swift build

# Run the app
./script/build_and_run.sh

# Add to Claude Desktop (~/.config/claude/claude_desktop_config.json)
{
  "mcpServers": {
    "applemcp": {
      "command": "/path/to/AppleMCP/.build/debug/M3MCPBridge"
    }
  }
}

# Or add to Claude Code
claude mcp add applemcp /path/to/AppleMCP/.build/debug/M3MCPBridge
View on GitHub