# applesauce

The applesauce MCP server for Claude Code connects an assistant to Apple apps on macOS. It can search mail and notes, manage calendar items, and run Shortcuts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: akshitanchan
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akshitanchan/applesauce
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/applesauce

## What it does

applesauce gives an assistant tools for Calendar, Reminders, Mail, Notes, and Contacts on a Mac. It can also run Shortcuts, find files with Spotlight, and access the clipboard. The client communicates with the server over MCP through stdin and stdout.

macOS 14 or later is required. Installing through `npx` also requires Node 18 or later. Mail and Notes must be running, and macOS asks for app access the first time a tool needs it. Full Disk Access makes mail search faster; without it, searches cover a mailbox and a date range. Permissions may need approval again after an update. The `--read-only` flag hides tools that change data.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add applesauce -- npx -y applesauce
```

### Codex

**Platform CLI**
```bash
codex mcp add applesauce -- npx -y applesauce
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "applesauce": {
            "command": "npx",
            "args": [
                "-y",
                "applesauce"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "applesauce": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "applesauce"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add applesauce npx -y applesauce
```

## When to use it
- search mail for a message about a meeting
- create a calendar event or reminder
- find a note, contact, or file on a Mac
- run a Shortcuts action through an assistant

## Example prompts
- Find emails about next week's meeting.
- Create a reminder for tomorrow's call.
- Find the note with the project launch plan.

## Similar
- [agentix-ceo](https://affpapa.org/en/nevibecode/skills/agentix-ceo.md) — skill · 83500 installs
- [airtable-automation](https://affpapa.org/en/nevibecode/skills/airtable-automation.md) — skill · 6400 installs
- [nblm](https://affpapa.org/en/nevibecode/skills/nblm.md) — skill · 6300 installs
- [File Organizer](https://affpapa.org/en/nevibecode/skills/claude-office-skills-file-organizer.md) — skill · 5700 installs
- [influence-and-negotiation](https://affpapa.org/en/nevibecode/skills/influence-and-negotiation.md) — skill · 5400 installs
- [om-auto-create-pr](https://affpapa.org/en/nevibecode/skills/om-auto-create-pr.md) — skill · 4700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
