Agent♥︎Age
Catalog

Apple Files

Official

by JonathanRReed · Python

Inspect and manage local files and folders inside allowed roots on macOS.

This MCP server inspects and manages local files and folders inside allowed roots on macOS. It supports Finder-adjacent operations for file listing, searching, and text reading, along with metadata, recent items, and Finder integration. It also includes iCloud Drive availability reporting and workflows involving Finder tags.

🛠️ Key Features

  • List allowed file roots
  • Inspect directory contents
  • Search files and folders by name
  • Read UTF-8 text files
  • Inspect file metadata
  • List recent files and recent locations
  • Open a path in the default app
  • Reveal a path in Finder
  • Read and write Finder tags
  • Report local iCloud Drive availability
  • Create folders; move or rename paths; delete files or empty folders
  • Resources: files://allowed-roots

🚀 Use Cases

  • File exploration within configured roots
  • Name-based search for files and folders
  • Inspecting metadata and recent activity
  • Finder tag management and Finder navigation
  • iCloud Drive availability checks for local workflows

⚡ Developer Benefits

  • Structured file and folder operations within allowed roots
  • UTF-8 text reading for local content
  • Finder-integrated actions (open/reveal) and tag updates
  • iCloud Drive availability reporting for macOS workflows

⚠️ Limitations

  • Operates on local files and folders inside allowed roots on macOS.

Topics

applemcpmcpserverai-agentapple-calendarapple-mailapple-notesapple-remindersapple-shortcutsapplescriptautomationclaudeimessagemacosmodel-context-protocolproductivitypython