Apple Files runs on your own machine — the client starts it, so there is no endpoint to ping. 1 513 installs a week from pypi. Last commit 14 Oct 2026.
Inspect and manage local files and folders inside allowed roots on macOS.
What the code does
We read the source, 1 d ago · rules ccca72095570
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
result = subprocess.run(
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add apple-files-mcp -- uvx apple-files-mcp{
"mcpServers": {
"apple-files-mcp": {
"args": [
"apple-files-mcp"
],
"command": "uvx"
}
}
}[mcp_servers.apple-files-mcp]
command = "uvx"
args = ["apple-files-mcp"]{
"mcpServers": {
"apple-files-mcp": {
"args": [
"apple-files-mcp"
],
"command": "uvx"
}
}
}{
"mcpServers": {
"apple-files-mcp": {
"args": [
"apple-files-mcp"
],
"command": "uvx"
}
}
}This one needs environment variables set before it will start:
APPLE_FILES_MCP_SAFETY_MODE (Safety mode for file operations: safe_readonly, safe_manage, or full_access.), APPLE_FILES_MCP_ALLOWED_ROOTS (Comma-separated directories the server may access. Defaults to Desktop, Documents, Downloads, and iCloud Drive.).
The author declared them in the registry entry; get the values from the project itself.
Alternatives to Apple Files
same job, measured the same wayList, inspect, and run Apple Shortcuts on macOS.
Local macOS tools for Apple apps, iWork documents, files, media, and Shortcuts.
Privacy-first local MCP for Apple Mail on macOS: inbox context, drafts, approvals, and follow-ups.
Allow AI systems to list, search, upload, download, and manage files and folders in Google Drive.
Inspect and search Apple Contacts on macOS, and resolve a contact into a message-ready recipient.
Inspect, audit and safely edit i18n locale JSON files from AI agents.
Inspect, search, create, edit, move, and organize notes in Apple Notes on macOS.
Local snapWONDERS MCP: hide, reveal, analyse and convert files on your own machine
Apple Files — questions
Answers built from our own checks of this server.