Set it up
- 1
Turn on Filesystem in your AI
In Claude: open Settings → Connectors and add Filesystem. In ChatGPT: Settings → Apps & Connectors.
- 2
Add it to your app once
Copy the short config below into your app. It just tells your AI where to find Filesystem.
- 3
Just ask
Tell it what you want in plain words — no special commands.
For example, say
“List all files in my current project folder and tell me what kind of project it is”
Need the exact config? Show it +
Add to your client
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents", "/Users/you/Desktop"]
}
}
}Paste into your client's MCP configuration file.
Quick skills
Copy one, paste it to your AI, watch it work.
Project Analysis
“Read all TypeScript files in ~/projects/myapp and tell me the architecture”
Content Generation
“Create a weekly report based on my notes in ~/notes/2025-02/ and save it as report.md”
In the wild
“I installed the filesystem MCP server made by Anthropic and it is a massive game changer for working with Claude Desktop to program. I guided Claude to develop a 3000 line python wrapper for ffmpeg”
“I've played a lot with the FileSystem MCP server but couldn't get it to do something useful that I can't already do faster on my own. For instance, asking it how many files have word "main" in it. It returns 267”
Good to know
- · The server only sees directories you explicitly whitelist — paths outside are blocked
- · Write access is powerful — AI can overwrite files, so scope to specific folders
- · Symlinks can escape whitelisted folders — follow the server's path-validation guidance
When to use
- ✓ You want Claude to read and understand your local project files
- ✓ You need AI to generate and save files to your computer
- ✓ You want to search through large numbers of local files
- ✓ You're building automations that work with local data
When not to use
- × You need to access files on a remote server (use SSH instead)
- × You're working with sensitive data without reviewing permission boundaries
- × You want cloud storage access (use Google Drive or Notion MCPs)
About
This server gives your AI assistant the ability to see and edit files on your computer — like giving it access to your file manager. You decide which folders it can access. Then you can ask it to 'summarize all notes in my Documents folder' or 'create a new file with this content' and it does it directly on your machine.
The official Anthropic Filesystem MCP server provides Claude and other AI assistants with controlled access to your local filesystem. Configure allowed directories, and the AI can read files, write content, list directories, search for patterns, and move files — all within security boundaries you define.
This is one of the most widely-used MCP servers and the canonical example of how MCP works in practice.
Workflows That Use Filesystem MCP
Go from a one-line topic to a researched, sourced first draft saved to disk — before your coffee is cold, every day.
Local filesystem, Git history, and your Obsidian vault — so Claude works from what you actually have, not guesses.
Works With
Also Consider
FAQ
What does Filesystem MCP do? +
This server gives your AI assistant the ability to see and edit files on your computer — like giving it access to your file manager. You decide which folders it can access. Then you can ask it to 'summarize all notes in my Documents folder' or 'create a new file with this content' and it does it directly on your machine.
Do I need to know how to code? +
No. Turn it on in your AI's settings and ask in plain English — no terminal, no coding.
When should I use Filesystem MCP? +
Reach for it when you need to: You want Claude to read and understand your local project files; You need AI to generate and save files to your computer; You want to search through large numbers of local files; You're building automations that work with local data.
When should I avoid Filesystem MCP? +
Skip it when: You need to access files on a remote server (use SSH instead); You're working with sensitive data without reviewing permission boundaries; You want cloud storage access (use Google Drive or Notion MCPs).
Is Filesystem MCP free? +
Filesystem MCP is free and open source (MIT license).
How do I install Filesystem MCP? +
In Claude Code, run: claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/you/Documents. Copy-paste configs for Claude Desktop, Cursor, and Windsurf are at the top of this page.
