Skip to content
Agentmart
Submit a tool

Apple Files

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

Connector by JonathanRReed · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 28
Write a review

Install

Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/jonathanrreed-apple-files-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Use cases: file-management

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
13 read · 6 write · 2 delete
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 21

Read from the source code; the running server may list different tools.

Read 13 · Look things up without changing anything.

  • files_get_file_info
  • files_get_icloud_status
  • files_get_prompt
  • files_get_tags
  • files_health
  • files_list_allowed_roots
  • files_list_directory
  • files_list_prompts
  • files_list_recent_locations
  • files_permission_guide
  • files_read_text_file
  • files_recent_files
Show 1 more tools
  • files_search_files

Write 6 · Create, change, send or run things.

  • files_add_tags
  • files_create_folder
  • files_move_path
  • files_open_path
  • files_reveal_in_finder
  • files_set_tags

Delete 2 · Delete, drop, revoke or wipe things.

  • files_delete_path
  • files_remove_tags

Secrets and settings it asks for

Other settings (environment variables or headers).

  • APPLE_FILES_MCP_ALLOWED_ROOTS
  • APPLE_FILES_MCP_SAFETY_MODE

Network hosts it talks to 3

  • docs.astral.sh · found in code
  • github.com · found in install command, code
  • raw.githubusercontent.com · found in code

Files it touches

  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (21)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • files_add_tagsAdd Tags

    Add Finder tags to a file or folder. Requires safe_manage or full_access safety mode.

  • files_create_folderCreate Folder

    Create a folder inside the allowed roots.

  • files_delete_pathDelete Path

    Delete a file or empty folder inside the allowed roots. Requires full_access safety mode.

  • files_get_file_infoGet File Info

    Get metadata for a file or folder inside the allowed roots.

  • files_get_icloud_statusGet iCloud Status

    Report whether local iCloud Drive is available and whether it is part of the current allowed roots.

  • files_get_promptFiles Get Prompt

    Fallback prompt rendering tool for tool-only MCP clients.

  • files_get_tagsGet Tags

    Read Finder tags for a file or folder inside the allowed roots.

  • files_healthFiles Health

    Report the active Apple Files MCP configuration.

  • files_list_allowed_rootsList Allowed Roots

    List the file system roots the server may access.

  • files_list_directoryList Directory

    List files and folders inside an allowed directory path.

  • files_list_promptsFiles List Prompts

    Fallback prompt discovery tool for tool-only MCP clients.

  • files_list_recent_locationsList Recent Locations

    List recently active parent folders across the allowed roots, including iCloud-aware metadata.

  • files_move_pathMove Path

    Move or rename a file or folder inside the allowed roots.

  • files_open_pathOpen Path

    Open a file or folder in the default app. Requires safe_manage or full_access safety mode.

  • files_permission_guideFiles Permission Guide

    Explain how Apple Files MCP access is scoped on this machine.

Show 6 more tools
  • files_read_text_fileRead Text File

    Read a UTF-8 text file inside the allowed roots.

  • files_recent_filesRecent Files

    List recently modified files inside the allowed roots.

  • files_remove_tagsRemove Tags

    Remove Finder tags from a file or folder. Requires safe_manage or full_access safety mode.

  • files_reveal_in_finderReveal In Finder

    Reveal a file or folder in Finder. Requires safe_manage or full_access safety mode.

  • files_search_filesSearch Files

    Search file and folder names inside the allowed roots.

  • files_set_tagsSet Tags

    Replace Finder tags for a file or folder. Requires safe_manage or full_access safety mode.

Signals

Stars
28
Forks
4
Open issues
0
Contributors
6
Weekly downloads
389
Last commit (this folder)
Oct 21, 2026 (7 days ago)
Last release
Oct 22, 2026 (7 days ago)
Last package publish
Oct 22, 2026 (7 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.JonathanRReed/apple-files-mcp
Version
1.1.3
Auth
No auth
Packages
pypi apple-files-mcpmcpb https://github.com/JonathanRReed/Apple-MCPs/releases/download/v1.1.3/apple-files-1.1.3.mcpb
License
MIT
Repository
github.com/JonathanRReed/Apple-MCPs
Website
github.com/JonathanRReed/Apple-MCPs
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from JonathanRReed

Cite this page

Apple Files MCP server. Agent Mart. https://agentmart.dev/connectors/jonathanrreed-apple-files-mcp (last updated 2026-10-24)