Skip to content
Back to search

apple-mcp

MCP servers for Apple apps (Notes, etc.) on macOS via AppleScript

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/griches--apple-mcp/badge.svg)](/listings/griches--apple-mcp)

HTML

<a href="/listings/griches--apple-mcp"><img src="/api/listings/griches--apple-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

All servers are published on [npm](https://www.npmjs.com/search?q=%40griches%2Fapple) under the `@griches` scope. No cloning or building required — install and run directly with `npx`:

# Apple Notes
npx @griches/apple-notes-mcp

# Apple Messages
npx @griches/apple-messages-mcp

# Apple Contacts
npx @griches/apple-contacts-mcp

# Apple Reminders
npx @griches/apple-reminders-mcp

# Apple Calendar
npx @griches/apple-calendar-mcp

# Apple Maps
npx @griches/apple-maps-mcp

# Apple Mail
npx @griches/apple-mail-mcp

Claude Code

claude mcp add apple-notes -- npx @griches/apple-notes-mcp
claude mcp add apple-messages -- npx @griches/apple-messages-mcp
claude mcp add apple-contacts -- npx @griches/apple-contacts-mcp
claude mcp add apple-reminders -- npx @griches/apple-reminders-mcp
claude mcp add apple-calendar -- npx @griches/apple-calendar-mcp
claude mcp add apple-maps -- npx @griches/apple-maps-mcp
claude mcp add apple-mail -- npx @griches/apple-mail-mcp

Claude Desktop

Add to your `claude_desktop_config.json`:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["@griches/apple-notes-mcp"]
    },
    "apple-messages": {
      "command": "npx",
      "args": ["@griches/apple-messages-mcp"]
    },
    "apple-contacts": {
      "command": "npx",
      "args": ["@griches/apple-contacts-mcp"]
    },
    "apple-reminders": {
      "command": "npx",
      "args": ["@griches/apple-reminders-mcp"]
    },
    "apple-calendar": {
      "command": "npx",
      "args": ["@griches/apple-calendar-mcp"]
    },
    "apple-maps": {
      "command": "npx",
      "args": ["@griches/apple-maps-mcp"]
    },
    "apple-mail": {
      "command": "npx",
      "args": ["@griches/apple-mail-mcp"]
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 431 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Apple MCP Servers
  2. A collection of [Model Context Protocol (MCP)](https://modelcontextprotocol.io) servers that provide AI assistants with access to native Apple applications on macOS.
  3. ## Servers
  4. | Server | NPM Package | Description |
  5. |--------|-------------|-------------|
  6. | [Apple Notes](#apple-notes) | [![npm](https://img.shields.io/npm/v/@griches/apple-notes-mcp)](https://www.npmjs.com/package/@griches/apple-notes-mcp) | Read, create, update, move, and delete notes and folders |
  7. | [Apple Messages](#apple-messages) | [![npm](https://img.shields.io/npm/v/@griches/apple-messages-mcp)](https://www.npmjs.com/package/@griches/apple-messages-mcp) | Read message history, search conversations, and send messages |
  8. | [Apple Contacts](#apple-contacts) | [![npm](https://img.shields.io/npm/v/@griches/apple-contacts-mcp)](https://www.npmjs.com/package/@griches/apple-contacts-mcp) | Manage contacts, groups, and contact details |
  9. | [Apple Mail](#apple-mail) | [![npm](https://img.shields.io/npm/v/@griches/apple-mail-mcp)](https://www.npmjs.com/package/@griches/apple-mail-mcp) | Read, send, search, flag, and manage email |
  10. | [Apple Reminders](#apple-reminders) | [![npm](https://img.shields.io/npm/v/@griches/apple-reminders-mcp)](https://www.npmjs.com/package/@griches/apple-reminders-mcp) | Create, update, complete, and manage reminders and lists |
  11. | [Apple Calendar](#apple-calendar) | [![npm](https://img.shields.io/npm/v/@griches/apple-calendar-mcp)](https://www.npmjs.com/package/@griches/apple-calendar-mcp) | Create, update, and manage calendar events |
  12. | [Apple Maps](#apple-maps) | [![npm](https://img.shields.io/npm/v/@griches/apple-maps-mcp)](https://www.npmjs.com/package/@griches/apple-maps-mcp) | Search locations, get directions, and drop pins (visual only — limited by Apple's automation support) |
  13. ## Requirements
  14. - **macOS 13+**
  15. - **Node.js** 18+ (22+ for Apple Messages)
  16. - **Full Disk Access** granted to your terminal app (System Settings > Privacy & Security > Full Disk Access) — required for reading the Messages database
  17. - **The associated Apple app must be running** for AppleScript-based servers (Notes, Contacts, Mail, Messages, Maps) — these communicate via AppleScript so the app needs to be open. Calendar and Reminders use EventKit directly and do not require the app to be open.
  18. ## Safety Modes
  19. All servers (except Apple Maps, which is UI-only) support two optional safety flags:
  20. | Mode | Flag | Behaviour |
  21. |------|------|-----------|
  22. | **Normal** (default) | _(none)_ | All tools available, no restrictions |
  23. | **Read-only** | `--read-only` | Destructive/write tools are not registered at all |
  24. | **Confirm** | `--confirm-destructive` | Destructive tools require a `confirm: true` parameter; without it they return a warning asking the AI to check with the user first |
  25. ### Claude Desktop
  26. ```json
  27. {
  28. "mcpServers": {
  29. "apple-notes": {
  30. "command": "npx",
  31. "args": ["@griches/apple-notes-mcp", "--read-only"]
  32. },
  33. "apple-messages": {
  34. "command": "npx",
  35. "args": ["@griches/apple-messages-mcp", "--confirm-destructive"]
  36. }
  37. }
  38. }
  39. ```
  40. ### Claude Code
  41. ```bash
  42. claude mcp add apple-notes -- npx @griches/apple-notes-mcp --read-only
  43. claude mcp add apple-messages -- npx @griches/apple-messages-mcp --confirm-destructive
  44. ```
  45. ### Destructive tools by server
  46. | Server | Destructive tools |
  47. |--------|-------------------|
  48. | Notes | `delete_note`, `delete_folder` |
  49. | Contacts | `delete_contact`, `delete_group` |
  50. | Reminders | `delete_reminder`, `delete_list` |
  51. | Calendar | `delete_event` |
  52. ## Installation
  53. All servers are published on [npm](https://www.npmjs.com/search?q=%40griches%2Fapple) under the `@griches` scope. No cloning or building required — install and run directly with `npx`:
  54. ```bash
  55. # Apple Notes
  56. npx @griches/apple-notes-mcp
  57. # Apple Messages
  58. npx @griches/apple-messages-mcp
  59. # Apple Contacts
  60. npx @griches/apple-contacts-mcp
  61. # Apple Reminders
  62. npx @griches/apple-reminders-mcp
  63. # Apple Calendar
  64. npx @griches/apple-calendar-mcp
  65. # Apple Maps
  66. npx @griches/apple-maps-mcp
  67. # Apple Mail
  68. npx @griches/apple-mail-mcp
  69. ```
  70. ### Claude Code
  71. ```bash
  72. claude mcp add apple-notes -- npx @griches/apple-notes-mcp
  73. claude mcp add apple-messages -- npx @griches/apple-messages-mcp
  74. claude mcp add apple-contacts -- npx @griches/apple-contacts-mcp
  75. claude mcp add apple-reminders -- npx @griches/apple-reminders-mcp
  76. claude mcp add apple-calendar -- npx @griches/apple-calendar-mcp
  77. claude mcp add apple-maps -- npx @griches/apple-maps-mcp
  78. claude mcp add apple-mail -- npx @griches/apple-mail-mcp
  79. ```
  80. ### Claude Desktop
  81. Add to your `claude_desktop_config.json`:
  82. ```json
  83. {
  84. "mcpServers": {
  85. "apple-notes": {
  86. "command": "npx",
  87. "args": ["@griches/apple-notes-mcp"]
  88. },
  89. "apple-messages": {
  90. "command": "npx",
  91. "args": ["@griches/apple-messages-mcp"]
  92. },
  93. "apple-contacts": {
  94. "command": "npx",
  95. "args": ["@griches/apple-contacts-mcp"]
  96. },
  97. "apple-reminders": {
  98. "command": "npx",
  99. "args": ["@griches/apple-reminders-mcp"]
  100. },
  101. "apple-calendar": {
  102. "command": "npx",
  103. "args": ["@griches/apple-calendar-mcp"]
  104. },
  105. "apple-maps": {
  106. "command": "npx",
  107. "args": ["@griches/apple-maps-mcp"]
  108. },
  109. "apple-mail": {
  110. "command": "npx",
  111. "args": ["@griches/apple-mail-mcp"]
  112. }
  113. }
  114. }
  115. ```
  116. ## Install from Source
  117. If you prefer to build from source:
  118. ```bash
  119. git clone https://github.com/griches/apple-mcp.git
  120. cd apple-mcp
  121. # Apple Notes
  122. cd notes && npm install && npm run build
  123. # Apple Messages
  124. cd ../messages && npm install && npm run build
  125. # Apple Contacts
  126. cd ../contacts && npm install && npm run build
  127. # Apple Reminders
  128. cd ../reminders && npm install && npm run build
  129. # Apple Calendar
  130. cd ../calendar && npm install && npm run build
  131. # Apple Maps
  132. cd ../maps && npm install && npm run build
  133. # Apple Mail
  134. cd ../mail && npm install && npm run build
  135. ```
  136. Then configure your MCP client to run the built files directly:
  137. ```json
  138. {
  139. "mcpServers": {
  140. "apple-notes": {
  141. "command": "node",
  142. "args": ["/absolute/path/to/notes/build/index.js"]
  143. },
  144. "apple-messages": {
  145. "command": "node",
  146. "args": ["/absolute/path/to/messages/build/index.js"]
  147. },
  148. "apple-contacts": {
  149. "command": "node",
  150. "args": ["/absolute/path/to/contacts/build/index.js"]
  151. },
  152. "apple-reminders": {
  153. "command": "node",
  154. "args": ["/absolute/path/to/reminders/build/index.js"]
  155. },
  156. "apple-calendar": {
  157. "command": "node",
  158. "args": ["/absolute/path/to/calendar/build/index.js"]
  159. },
  160. "apple-maps": {
  161. "command": "node",
  162. "args": ["/absolute/path/to/maps/build/index.js"]
  163. },
  164. "apple-mail": {
  165. "command": "node",
  166. "args": ["/absolute/path/to/mail/build/index.js"]
  167. }
  168. }
  169. }
  170. ```
  171. ---
  172. ## Apple Notes
  173. An MCP server that interacts with Apple Notes via AppleScript.
  174. ### Tools
  175. | Tool | Description |
  176. |------|-------------|
  177. | `list_folders` | List all folders in Apple Notes |
  178. | `create_folder` | Create a new folder |
  179. | `list_notes` | List all notes in a folder |
  180. | `get_note` | Get the full content of a note by title |
  181. | `create_note` | Create a new note (HTML body) in a folder |
  182. | `update_note` | Update the body of an existing note |
  183. | `move_note` | Move a note from one folder to another |
  184. | `append_to_note` | Append HTML content to an existing note |
  185. | `delete_note` | Delete a note |
  186. | `delete_folder` | Delete a folder and all its notes |
  187. | `search_notes` | Search notes by keyword in titles and body content |
  188. ### Usage Examples
  189. - "List my Apple Notes folders"
  190. - "Get my Shopping note"
  191. - "Create a note called Meeting Notes in my Work folder"
  192. - "Search my notes for recipes"
  193. ---
  194. ## Apple Messages
  195. An MCP server that reads messages from the macOS Messages database (SQLite) and sends messages via AppleScript.
  196. ### Tools
  197. | Tool | Description |
  198. |------|-------------|
  199. | `list_chats` | List recent chats with last message preview |
  200. | `get_chat_messages` | Get message history for a specific chat (with optional date range filtering) |
  201. | `search_messages` | Search messages by text content |
  202. | `send_message` | Send an iMessage or SMS |
  203. | `get_chat_participants` | Get participants of a chat |
  204. ### Permissions
  205. - **Reading messages**: Requires Full Disk Access for your terminal app to read `~/Library/Messages/chat.db`
  206. - **Sending messages**: macOS will prompt you to allow your terminal app to control the Messages app via AppleScript
  207. ### Usage Examples
  208. - "Show my recent messages"
  209. - "Search my messages for flight confirmation"
  210. - "Send a message to +1234567890 saying I'm on my way"
  211. ---
  212. ## Apple Contacts
  213. An MCP server that interacts with Apple Contacts via AppleScript.
  214. ### Tools
  215. | Tool | Description |
  216. |------|-------------|
  217. | `list_groups` | List all groups in Apple Contacts |
  218. | `list_contacts` | List all contacts, optionally filtered by group |
  219. | `get_contact` | Get full details of a contact (emails, phones, addresses, etc.) |
  220. | `search_contacts` | Search contacts by name |
  221. | `create_contact` | Create a new contact with optional email, phone, organization |
  222. | `update_contact` | Update an existing contact's details |
  223. | `delete_contact` | Delete a contact by name |
  224. | `create_group` | Create a new group |
  225. | `delete_group` | Delete a contact group |
  226. | `add_contact_to_group` | Add a contact to a group |
  227. | `remove_contact_from_group` | Remove a contact from a group |
  228. ### Usage Examples
  229. - "List all my contacts"
  230. - "Find contacts named John"
  231. - "Get details for Jane Smith"
  232. - "Create a contact for Bob Jones at Acme Corp"
  233. ---
  234. ## Apple Reminders
  235. An MCP server that interacts with Apple Reminders via EventKit — fast, reliable, and no dependency on the Reminders app being open.
  236. ### Tools
  237. | Tool | Description |
  238. |------|-------------|
  239. | `list_lists` | List all reminder lists |
  240. | `create_list` | Create a new reminder list |
  241. | `list_reminders` | List reminders with a due date in a list (optionally include completed) |
  242. | `get_reminder` | Get full details of a reminder by name or id |
  243. | `create_reminder` | Create a new reminder with optional due date, notes, and priority |
  244. | `update_reminder` | Update an existing reminder's details (by name or id) |
  245. | `complete_reminder` | Mark a reminder as completed (by name or id) |
  246. | `uncomplete_reminder` | Mark a completed reminder as incomplete (by name or id) |
  247. | `delete_reminder` | Delete a reminder (by name or id) |
  248. | `delete_list` | Delete a reminder list and all its reminders |
  249. | `search_reminders` | Search reminders by name across lists |
  250. ### Usage Examples
  251. - "Show my reminder lists"
  252. - "List reminders in my Shopping list"
  253. - "Create a reminder to buy milk in my Groceries list"
  254. - "Mark the dentist appointment reminder as done"
  255. ---
  256. ## Apple Calendar
  257. An MCP server that interacts with Apple Calendar via EventKit — fast, reliable, and no dependency on the Calendar app being open for reads. Write operations (create, update, delete) use AppleScript.
  258. ### Permissions
  259. - **Calendar access**: macOS will prompt you to grant calendar access the first time the server runs (System Settings > Privacy & Security > Calendars)
  260. - **Creating/updating/deleting events**: macOS will prompt you to allow your terminal app to control the Calendar app via AppleScript
  261. ### Tools
  262. | Tool | Description |
  263. |------|-------------|
  264. | `list_calendars` | List all calendars |
  265. | `list_all_events` | List events across all calendars within a date range |
  266. | `list_events` | List events in a specific calendar within a date range |
  267. | `get_event` | Get full details of an event by summary/title, including alerts |
  268. | `create_event` | Create a new event with date, time, location, description, and optional alerts |
  269. | `update_event` | Update an existing event's details, including alerts |
  270. | `delete_event` | Delete an event by summary/title |
  271. | `search_events` | Search events by summary/title across calendars |
  272. ### Usage Examples
  273. - "List my calendars"
  274. - "Show events in my Work calendar for next week"
  275. - "Create a meeting tomorrow at 2pm in my Work calendar"
  276. - "Create a dentist appointment on Friday at 10am with an alert 2 hours before"
  277. - "Add a 30-minute alert to my Team Standup event"
  278. - "Search for events about standup"
  279. ---
  280. ## Apple Maps
  281. An MCP server that interacts with Apple Maps using Maps URL schemes.
  282. > **Note:** Apple Maps has a very limited AppleScript/automation dictionary compared to other Apple apps. There is no supported way to programmatically read back search results, route details, or location data from Maps. As a result, these tools open Apple Maps with the requested query but cannot return structured data (e.g. addresses, coordinates, distances) to the agent. The results are visual — you'll see them in the Maps app.
  283. ### Tools
  284. | Tool | Description |
  285. |------|-------------|
  286. | `search_location` | Search for a location in Apple Maps |
  287. | `get_directions` | Get directions between two locations (driving, walking, or transit) |
  288. | `drop_pin` | Drop a pin at specific coordinates |
  289. | `open_address` | Open a specific address in Apple Maps |
  290. | `save_to_favorites` | Open a location in Maps so you can save it as a favorite |
  291. ### Usage Examples
  292. - "Search for coffee shops near Times Square"
  293. - "Get walking directions from Central Park to the Met"
  294. - "Show me 1 Apple Park Way, Cupertino on a map"
  295. - "Drop a pin at 48.8584, 2.2945"
  296. ---
  297. ## Apple Mail
  298. An MCP server that interacts with Apple Mail via AppleScript.
  299. ### Tools
  300. | Tool | Description |
  301. |------|-------------|
  302. | `list_mailboxes` | List all mailboxes across accounts with unread counts |
  303. | `list_messages` | List recent messages in a mailbox, optionally filtered to unread only |
  304. | `get_message` | Get the full content of an email by ID |
  305. | `search_messages` | Search emails by subject or sender across mailboxes |
  306. | `send_email` | Send an email with optional CC/BCC (supports multiple recipients) |
  307. | `get_unread_count` | Get unread count for a mailbox or all mailboxes |
  308. | `move_message` | Move an email to a different mailbox |
  309. | `mark_read` | Mark an email as read or unread |
  310. | `delete_message` | Delete an email (moves to trash) |
  311. | `flag_message` | Flag or unflag an email message |
  312. ### Usage Examples
  313. - "How many unread emails do I have?"
  314. - "Show my recent emails in INBOX"
  315. - "Show my unread emails in INBOX"
  316. - "Search my email for invoices"
  317. - "Send an email to bob@example.com about the meeting"
  318. ---
  319. ## Development
  320. Each server is a standalone TypeScript project in its own directory.
  321. ```bash
  322. # Run tests for Notes
  323. cd notes
  324. npm test
  325. # Run tests for Messages
  326. cd messages
  327. npm test
  328. ```
  329. ## License
  330. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.