# Apple Files

> Apple Files is an open-source MCP server for files and documents. Local macOS file, Finder and iCloud Drive access for agents, limited to allowed folders. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/jonathanrreed/apple-mcps/tree/HEAD/AppleFiles-MCP
- **MCP Registry name:** io.github.JonathanRReed/apple-files-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add apple-files-mcp -- uvx apple-files-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "apple-files-mcp": {
      "command": "uvx",
      "args": [
        "apple-files-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "apple-files-mcp": {
      "command": "uvx",
      "args": [
        "apple-files-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "apple-files-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-files-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "apple-files-mcp": {
      "command": "uvx",
      "args": [
        "apple-files-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "apple-files-mcp": {
      "command": "uvx",
      "args": [
        "apple-files-mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.
- [Google_sheets](https://ai-powered.com/mcp/google-sheets-3): Google_sheets is a freemium MCP server for files and documents.
- [Onedrive](https://ai-powered.com/mcp/onedrive): Onedrive is a freemium MCP server for files and documents.
- [Zovo Spreadsheet Compare](https://ai-powered.com/mcp/zovo-spreadsheet-compare): Zovo Spreadsheet Compare is an MCP server for files and documents.
- [Video to Audio Converter MCP](https://ai-powered.com/mcp/video-to-audio-converter-mcp): Video to Audio Converter MCP is a free MCP server for design and media.
- [Google_drive](https://ai-powered.com/mcp/google-drive-5): Google_drive is a freemium MCP server for files and documents.
- [Markdown](https://ai-powered.com/mcp/markdown-2): Markdown is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/apple-files
