Skip to content
MCP server

Apple Files

Local macOS file, Finder and iCloud Drive access for agents, limited to allowed folders

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "apple-files-mcp": {
      "command": "uvx",
      "args": [
        "apple-files-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-files-mcp": {
      "command": "uvx",
      "args": [
        "apple-files-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers