Apple Files
Local macOS file, Finder and iCloud Drive access for agents, limited to allowed folders
- Pricing
- Open source
- Platforms
- macOS, CLI
- Runs
- Locally
- Version
- 1.1.7
- Listing updated
- today
Similar MCP servers
About Apple Files
Apple Files is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Apple Files MCP lets an assistant list, search and read text files, handle Finder tags, and organise paths on a Mac. Access is bound by allowed roots that default to Desktop, Documents, Downloads and iCloud Drive; the README advises keeping them narrow.
Actions include inspecting metadata, listing recent files and locations, revealing a path in Finder, creating folders, moving or renaming, and deleting files or empty folders. Moves reject existing destinations, allowed roots cannot be moved or deleted, and text reads are capped to a bounded prefix between 1 byte and 10 MB. Safety modes gate changes, and the README suggests full_access only for delete workflows.
It runs over stdio with uvx.
Install
Run in a terminal
claude mcp add apple-files-mcp -- uvx apple-files-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"apple-files-mcp": {
"command": "uvx",
"args": [
"apple-files-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"apple-files-mcp": {
"command": "uvx",
"args": [
"apple-files-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"apple-files-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-files-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"apple-files-mcp": {
"command": "uvx",
"args": [
"apple-files-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"apple-files-mcp": {
"command": "uvx",
"args": [
"apple-files-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
APPLE_FILES_MCP_SAFETY_MODESafety mode for file operations: safe_readonly, safe_manage, or full_access.APPLE_FILES_MCP_ALLOWED_ROOTSComma-separated directories the server may access. Defaults to Desktop, Documents, Downloads, and iCloud Drive.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- files_health
- Checks server health.
- files_permission_guide
- Explains permission fixes.
- files_list_allowed_roots
- Lists allowed folders.
- files_get_icloud_status
- Reports iCloud Drive availability.
- files_list_recent_locations
- Lists recent locations.
- files_get_tags
- Reads Finder tags.
What it does
- Allowed roots
- Confine access to chosen folders.
- Search and read
- Find files by name and read UTF-8 text.
- Finder tags
- Read and write tags.
- iCloud status
- Report local iCloud Drive availability.
- File operations
- Create, move, rename and delete.
- Safety modes
- Read-only, manage or full access.
Good for
- Find a document before attaching it to an email
- Tag project files
- Tidy a Downloads folder
- Check iCloud Drive availability
Pricing
Open source
Free; runs locally
Apple Files FAQ
Which folders are default?
Desktop, Documents, Downloads and iCloud Drive.
Can it delete?
Only in full_access.
Install?
uvx apple-files-mcp.
Is Apple Files free?
Yes. Apple Files is open source, so you can use and self-host it for free.
How do I add Apple Files to Claude Code?
Run this command in your terminal: claude mcp add apple-files-mcp -- uvx apple-files-mcp
What are the best alternatives to Apple Files?
The closest alternatives to Apple Files are SSRS2, Csv, Google_sheets, Onedrive and Zovo Spreadsheet Compare.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
