Apple Files MCP Server

Local MCP server for file, Finder-adjacent, and iCloud Drive workflows on macOS. list allowed file roots inspect directory contents search files and folders by name read UTF-8 text files inspect file metadata list recent files open a path in the default app reveal a path in Finder read and write Finder tags list recent locations report local iCloud Drive availability create folders move or rename paths delete files…

People who work with Apple and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

One of 11 MCP servers published from jonathanrreed/apple-mcps. Stars and repository activity are shared across all of them. See all 11 →

VERIFIED ACTIVE

LAST COMMIT 2026-09-14 · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Apple Files

before you install - you'll need

Set APPLE_FILES_MCP_ALLOWED_ROOTS, APPLE_FILES_MCP_SAFETY_MODE before connecting.

Claude Code

claude mcp add jonathanrreed-apple-mcps-applefiles-mcp -- uvx apple-files-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "jonathanrreed-apple-mcps-applefiles-mcp": {
      "command": "uvx",
      "args": [
        "apple-files-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · Claude Desktop extension (.mcpb bundle)

license MIT - declared in the repository

pypi package apple-files-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.JonathanRReed is GitHub-verified and matches the repo owner

03 · What Apple Files can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.0.4 · 2026-09-04

This release fixes security and native-app reliability issues and updates MCP compatibility across the Apple MCP suite. · Upgrade with uvx --refresh apple-tools-mcp@1.0.4, or install the matching standalone package or…

v1.0.3 · 2026-09-01

add maintainer and portfolio identity metadata · Fix Calendar create/get/update/delete under write-only EventKit access · Bound Notes AppleScript calls and resolve ambiguous create timeouts · Harden repo maintenance…

v1.0.2 · 2026-08-05

04 · Who maintains Apple Files

Apple Files is maintained by jonathanrreed. We track 11 MCP servers from jonathanrreed - 11 actively maintained, 15 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from jonathanrreed.

  1. Apple Calendar List, create, update, and delete events in Apple Calendar on macOS. ★ 15
  2. Apple Mail Read, search, compose, and send emails via Apple Mail on macOS. ★ 15
  3. Apple Reminders List, create, update, complete, and delete reminders in Apple Reminders on macOS. ★ 15
  4. Apple Contacts Inspect and search Apple Contacts on macOS, and resolve a contact into a message-ready recipient. ★ 15
  5. Apple Notes Inspect, search, create, edit, move, and organize notes in Apple Notes on macOS. ★ 15
  6. Apple Messages Read Messages history on macOS and send or reply through Messages.app. ★ 15

05 · Facts

repository
github.com/jonathanrreed/apple-mcps
website
https://github.com/JonathanRReed/Apple-MCPs
category
other - actively maintained as of 2026-09-18.
registry
io.github.JonathanRReed/apple-files-mcp (active, first published 2026-08-05 · 3 versions)
packages
pypi:apple-files-mcp · mcpb:https://github.com/JonathanRReed/Apple-MCPs/releases/download/v1.0.4/apple-files-1.0.4.mcpb

06 · Apple Files FAQ

What is Apple Files?

Local MCP server for file, Finder-adjacent, and iCloud Drive workflows on macOS. list allowed file roots inspect directory contents search files and folders by name read UTF-8 text files inspect file metadata list recent files open a path in the default app reveal a path in Finder read and write Finder tags list recent locations report local iCloud Drive availability create folders move or rename paths delete files…

Is Apple Files still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-14. We re-verify nightly.

How do I install Apple Files?

Run `uvx apple-files-mcp`. The README documents 2 environment variables (APPLE_FILES_MCP_ALLOWED_ROOTS, APPLE_FILES_MCP_SAFETY_MODE) to set first. Set APPLE_FILES_MCP_ALLOWED_ROOTS, APPLE_FILES_MCP_SAFETY_MODE before connecting. You can also paste the ready-made client config above.

Does Apple Files run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Apple Files

Alternatives to Apple Files

Maintained other servers if Apple Files isn't the fit.

  1. Heyputer MCP Server Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more ★ 43,552 · 2026-09-17
  2. Server Commands An MCP server to run arbitrary commands ★ 39,038 · 2026-09-11
  3. basebalance.cloud - x402 RPC & MCP gateway USDC-gated Base JSON-RPC: free 10 req/min, $0.50 per 10k. Failover, cache, /mcp, ledger. ★ 6,432 · 2026-08-26
  4. Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 5,069 · 2026-09-15
  5. Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,470 · 2026-09-18
  6. Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,681 · 2026-09-17

More MCP servers to compare · Apple Notes (jonathanrreed) · Apple Reminders · Apple Shortcuts (jonathanrreed) · Apple System · .NET MCP Server

More Python MCP servers · Apple Mail · Apple Maps (jonathanrreed) · Apple Messages (jonathanrreed) · see all