# Apple Tools (Unified)

> Apple Tools (Unified) is an open-source MCP server for productivity. Single MCP server bundling Apple Mail, Calendar, Notes, Files, Messages and Maps on macOS. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/jonathanrreed/apple-mcps/tree/HEAD/Apple-Tools-MCP
- **MCP Registry name:** io.github.JonathanRReed/apple-tools-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

Rather than wiring ten separate servers, this one entrypoint wraps the standalone Apple servers for Mail, Calendar, Reminders, Messages, Contacts, Notes, Shortcuts, Files, System and Maps. Its added value is cross-app work: daily and weekly briefings, communications triage, meeting prep, follow-up capture, and routing a message by mail or Messages according to saved defaults and per-contact preferences.

Actions that change things can be previewed, audited and undone. File access is limited to configured roots, and each domain has its own safety mode with safe_manage as the usual default, so replies and forwards are saved as drafts unless Mail is set to full_access. A bounded GUI fallback exists for tasks a native app domain cannot finish. Messages responses carry contact names when Contacts access is already granted and explain why names are missing otherwise.

Tool discovery uses search_tools and get_tool_info for clients that cannot load a large tool list. It needs macOS, Python 3.11+ when run from a clone, and the matching macOS permissions per app.

## Features

- **Ten Apple domains:** Mail, Calendar, Reminders, Messages, Contacts, Notes, Shortcuts, Files, System and Maps.
- **Briefing tools:** Daily, weekly and communications-triage briefings.
- **Saved defaults:** Default accounts, folders and preferred channel, plus per-contact overrides.
- **Preview, audit, undo:** Reversible actions can be previewed, listed and undone.
- **Scoped file roots:** File access is limited to configured folders.
- **Per-domain safety modes:** Each app has its own read-only, manage or full access setting.

## Good for

- Prepare a daily briefing across mail and calendar
- Triage messages and mail in one pass
- Capture a follow-up as a reminder and note
- Plan travel using Maps route estimates
- Undo a recent assistant action

## Install

### Claude Code (Terminal)

```sh
claude mcp add apple-tools-mcp -- uvx apple-tools-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "apple-tools-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ]
    }
  }
}
```

## Tools

- `search_tools`: Finds tools by name, alias or domain tag.
- `get_tool_info`: Loads the full schema and examples for one tool.
- `apple_list_prompts`: Lists prompts as a fallback for clients without prompt support.
- `apple_get_prompt`: Fetches one prompt.
- `apple_health`: Reports health without requesting permissions.
- `apple_permission_guide`: Explains macOS permissions needed.
- `apple_recheck_permissions`: Rechecks permissions.
- `apple_overview`: Returns an overview without probing apps.
- `apple_detect_defaults`: Returns or discovers saved default targets.
- `apple_get_preferences`: Reads saved preferences.
- `apple_update_preferences`: Updates saved preferences.

## FAQ

### How do I install it?

Run uvx apple-tools-mcp on a Mac.

### Will it send email on its own?

Not by default; replies and forwards become drafts unless Mail is set to full_access.

### Can I limit file access?

Yes, with APPLE_FILES_MCP_ALLOWED_ROOTS.

### Does the overview request permissions?

No. apple_health, apple_recheck_permissions and apple_overview do not send Apple Events or request new permissions.

### Can I use one app only?

Yes, standalone servers exist for each app.

### Is Apple Tools (Unified) free?

Yes. Apple Tools (Unified) is open source, so you can use and self-host it for free.

### How do I add Apple Tools (Unified) to Claude Code?

Run this command in your terminal: claude mcp add apple-tools-mcp -- uvx apple-tools-mcp

### What are the best alternatives to Apple Tools (Unified)?

The closest alternatives to Apple Tools (Unified) are Ha MCP, Concord MCP, note1, InviteKit Calendar Files and Google Workspace MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp-2): Google Workspace MCP is an MCP server for productivity.
- [Google_calendar](https://ai-powered.com/mcp/google-calendar-3): Google_calendar is a freemium MCP server for productivity.
- [Zovo Org Chart Maker](https://ai-powered.com/mcp/zovo-org-chart-maker): Zovo Org Chart Maker is an MCP server for productivity.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/apple-tools-unified
