Filesystem MCP
Read, write, and search local files from Claude.
Best for
Anyone running Claude locally who wants safe, scoped read/write access to a specific set of folders on their machine.
At a glance
- Pricing
- free
- Setup time
- 15 minutes
- Learning curve
- medium
- Last verified
- 5/26/2026
What we love
- ✓Official Anthropic reference implementation — well maintained
- ✓Path allowlist prevents accidental access outside scope
- ✓Works with any MCP-compatible client, not just Claude
Where it falls short
- −No built-in versioning or undo for writes
- −Symlink handling depends on host OS behavior
- −Large file reads can hit context limits quickly
Install & connect
Copy-paste ready
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Desktop"]
}
}
}{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
}
}
}claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/you/Desktop
{
"servers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
}
}
}Pricing
✓ Pricing verified Jun 21, 20261 tier
Open source
MIT license
- ✓Self-hosted via npm or Docker
- ✓Free forever
- ✓No telemetry
Why we picked it
The first MCP installed on any new Claude setup. Daily workflows depend on it.
Overview
Official Anthropic MCP server giving Claude full filesystem access — read, write, list, search files in scoped directories. The foundational MCP server.
Key features
- ●Read files and directories with permission scoping
- ●Write and edit files with diff-style operations
- ●Search across folders with glob and content patterns
- ●List directory contents with metadata
- ●Move and rename files within allowed paths
- ●Restricts access to a configured allowlist of folders
Exposed tools
The MCP-tool names this server exposes. Your agent can invoke any of these when this server is connected.
- read_text_fileRead complete contents of a UTF-8 text file. Optional head/tail to limit lines.
- read_media_fileRead an image or audio file as base64 with the correct MIME type.
- read_multiple_filesRead multiple files at once. Partial failures don't stop the batch.
- write_fileCreate a new file or overwrite an existing one. Destructive.
- edit_fileSelective edits via pattern matching with git-style diff output and dry-run support.
- create_directoryCreate a directory, including parents. Idempotent.
- list_directoryList directory contents with [FILE]/[DIR] prefixes.
- list_directory_with_sizesLike list_directory but includes file sizes and summary stats.
- move_fileMove or rename files and directories. Fails if destination exists.
- search_filesRecursive glob-style search with exclude patterns.
- directory_treeRecursive JSON tree of directory contents with exclude support.
- get_file_infoSize, timestamps, type, and permissions metadata for a path.
- list_allowed_directoriesShow which directories this server is allowed to access.
Best use cases
Local doc and note editing
Let Claude read and update your Obsidian vault, project notes, or markdown library.
Code review against local checkout
Point Claude at a repo on disk and have it scan, summarize, or edit files in place.
Bulk file operations
Rename, reorganize, or rewrite hundreds of files with a single conversational instruction.
Integrations
Similar tools
See all mcp →One AI Stack pick every week.
The tool we’d pay for this week, why we’d pay for it, and what we’d skip. No promo spam.