applesauce
Provides tools for working with native Apple apps and macOS system features, including Calendar events, Reminders, Mail, Notes, Contacts, Shortcuts, Spotlight file search, clipboard access, notifications, and opening items.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
applesauce
One MCP server for the Apple apps on your Mac.

applesauce is one small native program, written in Swift. It lets an AI assistant work with your Calendar, Reminders, Mail, Notes and Contacts. It can also run Shortcuts, search files with Spotlight, and use the clipboard. It talks to the assistant over MCP (the Model Context Protocol) on stdin and stdout.
Needs macOS 14 or newer. Works on Apple silicon and Intel.
No account, no cloud. Everything runs on your Mac.
Mail search is fast when it can read the Mail index (see Full Disk Access below).
Every error says what went wrong and how to fix it.
Tools
42 tools in 8 modules, plus doctor.
Module | Tools |
calendar |
|
reminders |
|
| |
notes |
|
contacts |
|
shortcuts |
|
spotlight |
|
system |
|
always on |
|
Related MCP server: apple-mcp
Install
You need macOS 14 or newer. For the npm route you also need Node 18 or newer.
Claude Code
claude mcp add applesauce -- npx -y applesauceClaude desktop with npx
Open ~/Library/Application Support/Claude/claude_desktop_config.json and add this:
{
"mcpServers": {
"applesauce": {
"command": "npx",
"args": ["-y", "applesauce"]
}
}
}Restart Claude desktop. To add a flag, put it in args, for example ["-y", "applesauce", "--read-only"].
Claude desktop with the .mcpb bundle
Download
applesauce-<version>.mcpbfrom the GitHub releases page.Double-click the file. Claude desktop opens an install dialog.
Click Install. The dialog has three settings: read-only mode, only these modules, turn off these modules.
Any other MCP client
Run npx -y applesauce. It speaks MCP on stdin and stdout.
Flags and environment variables
applesauce [serve] [options] run the MCP server (default)
applesauce doctor [options] show the state of each macOS permission and how to fix it
applesauce --version
applesauce --helpFlag | Environment variable | Meaning |
|
| Turn on only these modules. |
|
| Turn off these modules. |
|
| Hide every tool that changes data. |
Module names: calendar, reminders, mail, notes, contacts, shortcuts, spotlight, system. A flag wins over its environment variable. An empty APPLESAUCE_MODULES means all modules.
Permissions
macOS keeps your data private. The first time a tool needs an app, macOS shows a prompt. Click Allow. The prompt names applesauce, not your terminal or Claude.
Permission | Used by | Notes |
Calendars | calendar | Prompt on the first calendar tool. Full access, so events can be read and changed. |
Reminders | reminders | Prompt on the first reminders tool. |
Contacts | contacts | Prompt on the first contacts tool. |
Automation for Mail | Prompt on the first mail tool. If Mail is not running, applesauce opens it hidden in the background and leaves it open. | |
Automation for Notes | notes | Prompt on the first notes tool. Notes must be running. |
Full Disk Access | mail search | Optional. Gives fast search over all mail. |
Spotlight, Shortcuts, the clipboard and open need no permission of their own. The first notify asks to show notifications. Until you allow it, notifications still appear, with the Script Editor icon. After that they show the applesauce icon.
Full Disk Access for fast Mail search
Without it, search_mail still works. It is slower, needs a mailbox, and looks at a date range only. With it, applesauce reads the Mail index directly, read-only.
Ask your assistant to run the
doctortool, or runnpx -y applesauce doctorin a terminal. Copy thebinary:path, up to and includingapplesauce.app.Open System Settings, Privacy & Security, Full Disk Access.
Click
+. Press Cmd+Shift+G and paste the path. Selectapplesauce.appand click Open.Restart your AI app.
Permissions reset after an update
applesauce has no paid Apple signing, only an ad-hoc signature. macOS ties a permission to the exact binary. After each update, macOS may ask again, and Full Disk Access must be added again. With npx, a new version is a new file, so the same applies.
After an update, ask your assistant to run the doctor tool, or run npx -y applesauce doctor. It shows each permission, its state, and the exact step that fixes it. If a permission shows as denied, open System Settings, Privacy & Security, find applesauce in the list, and turn it off and on again.
Safety
--read-only(or the read-only switch in the .mcpb dialog) hides every tool that changes data.send_mailandreplysend nothing unless the call hasconfirm: true. Without it they save a draft.Tools that delete, send or move mail are marked
destructiveHint: true. Most MCP clients ask you before they run them.Tools that only read are marked
readOnlyHint: true.run_shortcutruns a shortcut, and a shortcut can do anything on your Mac. Turn off theshortcutsmodule if you do not want that.Every call has a time limit (30 seconds, and 120 seconds for a permission prompt).
Attachments are saved only by
get_mail_attachmentandget_note_attachment. Both needconfirm: trueon every call, and--read-onlyhides them. A file is limited to 25 MB. It goes to~/Library/Caches/applesauce/attachments(private to your user) and is deleted after 24 hours.Contact notes are never returned.
What can be undone
Action | Undo | Gate |
Delete a note | Notes keeps it in Recently Deleted for 30 days. | none |
Delete up to 10 emails | Mail moves them to the Trash. | none |
Delete more than 10 emails, or move them to Trash or Junk | Mail moves them to the Trash or Junk. |
|
Delete emails that are already in the Trash | None. The delete is final. |
|
Delete an event or a reminder | The result has a full copy, so the assistant can create it again (with a new id). | none |
Delete all later occurrences of a recurring event | None. |
|
Without confirm: true, a gated call changes nothing and says why. Your assistant can still pass confirm: true by itself, so --read-only is the only hard block.
Attachments
get_mail_attachmentandget_note_attachmentsave one attachment as a file and return its absolute path.Images (JPEG, PNG, GIF, WebP) are also returned as an image. HEIC is converted to JPEG. An image above 5 MB is scaled down for the result. The saved file stays as it is.
PDF, plain text, RTF, DOC and DOCX files are also returned as text, cut at 100000 characters. A PDF without text (a scan) returns the path only. Other types return the path only.
Mail attachments that Mail has not downloaded cannot be saved. Notes cannot save drawings, scans, tables and links. The call then fails with an error.
search_mailandflag_messageknow the seven flag colors: red, orange, yellow, green, blue, purple and gray.
Limits
macOS 14 or newer.
No paid Apple signing and no notarization. Permissions reset after an update (see above).
Locked notes are not read.
Notes must be running. Mail is different: when a Mail tool needs it, applesauce opens Mail hidden in the background and leaves it open.
The Intel slice is built but not tested on Intel hardware.
Linux and Docker
applesauce needs macOS. The Dockerfile builds a Linux image for MCP directories that check servers in Docker. In that image applesauce starts and lists all its tools, and every tool call answers UNSUPPORTED_PLATFORM. doctor reports each permission as unsupported.
Build from source
You need Xcode with Swift 6.1 or newer.
swift build
swift test
scripts/sign.sh .build/debug/applesauce # needed for macOS to show permission promptsRelease build and packages:
scripts/build-universal.sh # dist/applesauce, arm64 + x86_64, ad-hoc signed
scripts/pack-npm.sh # dist/applesauce-<version>.tgz
scripts/pack-mcpb.sh # dist/applesauce-<version>.mcpb
scripts/version.sh --check # all version numbers agreeThe version lives in Sources/AppleSauceCore/Version.swift. Support/Info.plist, npm/package.json and mcpb/manifest.json must match it.
Credits
The self-disclaim pattern, which makes the binary own its permission prompts, comes from apple-reminders-mcp (source) by high5 ventures (MIT).
Built on the MCP Swift SDK.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.
Hosted email MCP for your own Gmail, Outlook.com, Microsoft 365, iCloud or IMAP inbox: read, search, draft, reply in thread, forward and file mail. It moves or flags up to 500 messages in one call, and a send leaves exactly one copy in Sent. A calendar is a separate connection, and connecting one adds diary and scheduling tools.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for Apple Calendar, Mail, Reminders, and Files on macOS using native frameworks.24 npm22MIT
- AlicenseBqualityCmaintenanceMCP server for macOS Apple apps. Enables read/write access to Notes, Reminders, Calendar, Contacts, and Safari using SQLite and JXA, all running locally.2817 npm4MIT
- AlicenseNot gradedqualityBmaintenanceA collection of MCP servers for Apple macOS apps (Mail, Contacts, Notes, Memory, Messages, Calendar, Reminders) enabling AI assistants to read, search, create, and update data via JXA, SQLite, and EventKit.33 npmMIT
- AlicenseBqualityDmaintenanceLocal MCP server for macOS native apps: Mail, Calendar, Reminders, Notes, Messages, and Contacts. Enables reading and organizing your Mac life through a single stdio process using AppleScript/JXA.4021 npm1MIT