# macOS Apps

> macOS Apps is a free MCP server for productivity. Local MCP server for Mail, Calendar, Notes and other macOS apps with previewed deletes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/elfensky/macos-apps-mcp
- **MCP Registry name:** io.github.elfensky/macos-apps-mcp
- **Categories:** productivity, communication
- **Listing updated:** 2026-11-16

## About

This macOS-only server reaches Mail, Calendar, Reminders, Notes, Messages, Contacts, Photos, Safari, Music and Shortcuts through one Python process (FastMCP, run with uvx). Searches return pointers: an id, a one-line summary and a link that opens the item in its app, with full bodies fetched separately and capped.

Safety is the main design theme. Tools are split into read, write and outbound tiers; send tools stay hidden until you enable them per app, and a read-only environment variable registers reads only. Deletes, moves and sends default to dry run, every write is logged to an audit file, and Mail messages are copied as .eml backups before a move so mail_undo can reverse it. The README states it makes no network requests of its own.

A doctor tool reports which macOS permissions are granted, and an optional signed daemon app can hold them for all clients.

## Features

- **Pointer results:** Searches return ids and links rather than full bodies.
- **Tiered writes:** Read, write and outbound tools are gated separately.
- **Dry-run defaults:** Deletes, moves and sends preview before acting.
- **Audit log:** Every write is recorded and readable through an audit tool.
- **Mail backup and undo:** Messages are saved as .eml before moves, and mail_undo reverses a batch.
- **Permission doctor:** Reports EventKit, Automation and other grants without dialogs.
- **Adapter switches:** Individual apps can be turned off to cut tool count.

## Good for

- Ask when you are free on Thursday afternoon
- Find emails that need a reply and open a draft
- Move newsletters to Archive after previewing
- Review reminders due this week

## Install

### Claude Code (Terminal)

```sh
claude mcp add macos-apps-mcp -- uvx macos-apps-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "macos-apps-mcp": {
      "command": "uvx",
      "args": [
        "macos-apps-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "macos-apps-mcp": {
      "command": "uvx",
      "args": [
        "macos-apps-mcp"
      ]
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "macos-apps-mcp": {
      "command": "uvx",
      "args": [
        "macos-apps-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "macos-apps-mcp": {
      "command": "uvx",
      "args": [
        "macos-apps-mcp"
      ]
    }
  }
}
```

## Tools

- `events`: Lists calendar events for today, the week or a date.
- `free_busy`: Returns merged busy intervals and free gaps.
- `reminders`: Lists reminders due today, overdue or by list.
- `create_event`: Creates a calendar event.
- `update_event`: Updates a calendar event by id.
- `mail_search`: Searches Mail and returns pointers.
- `mail_needs_response`: Finds emails that need a reply.
- `mail_reply`: Opens a reply as a draft in Mail.
- `move_mail`: Moves mail, previewing by default.
- `mail_undo`: Reverses a mail move or delete batch.
- `doctor`: Reports which macOS permissions are granted.
- `audit`: Reads the audit log back.

## FAQ

### Which platforms work?

macOS only, with Python 3.12 or later and uv.

### Does it send email by itself?

No. Send tools are off until you enable them, and mail_reply only opens a draft.

### Does it phone home?

The README says no telemetry and no network requests of its own.

### How do I install it?

Point your client at uvx macos-apps-mcp.

### Is macOS Apps free?

Yes. macOS Apps is free to use.

### How do I add macOS Apps to Claude Code?

Run this command in your terminal: claude mcp add macos-apps-mcp -- uvx macos-apps-mcp

### What are the best alternatives to macOS Apps?

The closest alternatives to macOS Apps are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## 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.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/macos-apps
