Apple Files MCP server
Inspect and manage local files and folders inside allowed roots on macOS.
15 stars
Reviews
Write oneNobody has reviewed Apple Files yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Apple Files tools (21, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
files_add_tagsAdd Finder tags to a file or folder. Requires safe_manage or full_access safety mode.
files_create_folderwrite actionCreate a folder inside the allowed roots.
files_delete_pathwrite actionDelete a file or empty folder inside the allowed roots. Requires full_access safety mode.
files_get_file_infoGet metadata for a file or folder inside the allowed roots.
files_get_icloud_statusReport whether local iCloud Drive is available and whether it is part of the current allowed roots.
files_get_promptFallback prompt rendering tool for tool-only MCP clients.
files_get_tagsRead Finder tags for a file or folder inside the allowed roots.
files_healthReport the active Apple Files MCP configuration.
files_list_allowed_rootsList the file system roots the server may access.
files_list_directoryList files and folders inside an allowed directory path.
files_list_promptsFallback prompt discovery tool for tool-only MCP clients.
files_list_recent_locationsList recently active parent folders across the allowed roots, including iCloud-aware metadata.
files_move_pathMove or rename a file or folder inside the allowed roots.
files_open_pathOpen a file or folder in the default app. Requires safe_manage or full_access safety mode.
files_permission_guideExplain how Apple Files MCP access is scoped on this machine.
files_read_text_fileRead a UTF-8 text file inside the allowed roots.
files_recent_filesList recently modified files inside the allowed roots.
files_remove_tagswrite actionRemove Finder tags from a file or folder. Requires safe_manage or full_access safety mode.
files_reveal_in_finderReveal a file or folder in Finder. Requires safe_manage or full_access safety mode.
files_search_filesSearch file and folder names inside the allowed roots.
files_set_tagsReplace Finder tags for a file or folder. Requires safe_manage or full_access safety mode.
Public scan report
scanner v0.1.9 · 2026-09-20 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 6 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Install directly
claude mcp add apple-files-mcp -- uvx apple-files-mcp
Apple Files: common questions
- Is Apple Files MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Apple Files safety report
- How do I install Apple Files?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Apple Files need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is Apple Files maintained?
- The last commit was 6 days ago (2026-09-14). The latest release is v1.0.4.