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 connecting this server to 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-08-21 · VERIFIED 2026-08-25

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.2 · 2026-08-05

v1.0.1 · 2026-08-05

v1.0.0 · 2026-08-05

1.0.0: MCP spec 2026-07-28 / SDK v2 modernization, uvx + MCPB + Registry distribution

04 · Who maintains Apple Files

Apple Files is maintained by jonathanrreed. We track 11 MCP servers from jonathanrreed - 11 actively maintained, 11 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. ★ 11
  2. Apple Maps Search places, estimate routes, and build Apple Maps links on macOS. ★ 11
  3. Apple Contacts Inspect and search Apple Contacts on macOS, and resolve a contact into a message-ready recipient. ★ 11
  4. Apple System Read and manage macOS system settings and perform scoped desktop actions. ★ 11
  5. Apple Shortcuts List, inspect, and run Apple Shortcuts on macOS. ★ 11
  6. Apple Reminders List, create, update, complete, and delete reminders in Apple Reminders on macOS. ★ 11

05 · Facts

repository
github.com/jonathanrreed/apple-mcps
website
https://github.com/JonathanRReed/Apple-MCPs
category
other - actively maintained as of 2026-08-25.
registry
io.github.JonathanRReed/apple-files-mcp (active, first published 2026-08-05)
packages
pypi:apple-files-mcp · mcpb:https://github.com/JonathanRReed/Apple-MCPs/releases/download/v1.0.2/apple-files-1.0.2.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-08-25, its last commit was 2026-08-21. 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,204 · 2026-08-24
  2. Server Commands An MCP server to run arbitrary commands ★ 38,704 · 2026-08-05
  3. Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 4,780 · 2026-08-25
  4. Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,460 · 2026-08-25
  5. Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,598 · 2026-08-21
  6. Ship Swift 40+ production-ready SwiftUI recipes for building full-stack iOS apps via MCP. ★ 2,968 · 2026-08-09

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

More Python MCP servers · Apple Mail · Apple Maps · Apple Messages · see all