filesystem-mcp
MCP server for filesystem operations - read, create, and edit files.
Use Cases
Save email attachments: "Download all PDFs from my accountant's emails this month" → searches Gmail for matching emails, extracts attachments, and saves them to a local folder.
Update config files: "Change the API endpoint from staging to production in my config" → finds the config file, replaces the URL, and shows you the diff.
Generate reports: "Create a summary of today's calendar events" → reads your calendar, formats a markdown report, and saves it to your notes folder.
Code refactoring: "Rename the function getData to fetchUserData in src/api.ts" → reads the file, makes the precise replacement, and confirms the change.
Backup before changes: "Save a copy of my .zshrc before I modify it" → reads the current file and writes a timestamped backup.
Setup
claude mcp add filesystem-mcp -- npx -y filesystem-mcp
Or with HTTP transport:
# Start the server
MCP_TRANSPORT=http PORT=3000 npx -y filesystem-mcp
# Add to Claude
claude mcp add --transport http filesystem-mcp http://localhost:3000/mcp
Tools
| Tool | Description |
|---|---|
view |
Read file contents or list directory (with line numbers) |
create |
Create or overwrite a file |
str_replace |
Replace an exact string in a file |
insert |
Insert text at a specific line |
Contributing
Pull requests are welcomed on GitHub! To get started:
- Install Git and Node.js
- Clone the repository
- Install dependencies with
npm install - Run
npm run testto run tests - Build with
npm run build
Releases
Versions follow the semantic versioning spec.
To release:
- Use
npm version <major | minor | patch>to bump the version - Run
git push --follow-tagsto push with tags - Wait for GitHub Actions to publish to the NPM registry.
