Apple Automation MCP

MCP server for Apple Mail Rules, Shortcuts, Keychain, and Books -- via AppleScript and CLI tools.

Install

npm install && npm run build

Usage

npm start

Tools (12)

Mail Rules (5)

| Tool | Description | |------|-------------| | mail_rules_list | List all Mail.app rules (name, conditions, actions, enabled status) | | mail_rule_create | Create a new mail rule (from/subject/content -> move/delete/flag/forward) | | mail_rule_toggle | Enable or disable a rule by name | | mail_rule_delete | Delete a rule by name | | mail_accounts_list | List all configured mail accounts with unread counts |

Shortcuts (3)

| Tool | Description | |------|-------------| | shortcuts_list_all | List all Shortcuts installed on this Mac | | shortcuts_run_with_input | Run a Shortcut with text input and capture output | | shortcuts_create_simple | Create a simple Shortcut from a template (open URL, send message, etc.) |

Keychain (2)

| Tool | Description | |------|-------------| | keychain_search | Search keychain for a service/account name (account info only, NO passwords) | | keychain_list_services | List all service names in the keychain (NO passwords) |

Books (2)

| Tool | Description | |------|-------------| | books_list | List all books in Apple Books (title, author, read status) | | books_reading_list | Get current reading list / Want to Read books |

Security

Keychain tools are read-only and never return actual passwords. They only return service names, account names, and existence confirmation.

MCP Registration

Add to ~/.mcp.json:

{
  "apple-automation": {
    "command": "node",
    "args": ["/Volumes/Virtual Server/projects/apple-automation-mcp/dist/index.js"]
  }
}

Requirements

• macOS (AppleScript, shortcuts CLI, security CLI)
• Node.js 18+
• Mail.app must be configured for mail rule tools
• Apple Books must have been used for books tools
• Accessibility permissions may be needed for Shortcuts creation