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

Chalk Labs

Need help deploying Apple Files?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

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.

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 (9 days ago)
Last release: Oct 22, 2026 (9 days ago)
Last package publish: Oct 22, 2026 (9 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 Registry github-graphql

More from JonathanRReed

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped: 50+; launches shipped
media placements: 500+; media placements
founders on every account: 2; founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get Apple Files running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Need help deploying Apple Files?

Call Get help

Cite this page

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