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
Or with HTTP transport:
Tools
Tool | Description |
| Read file contents or list directory (with line numbers) |
| Create or overwrite a file |
| Replace an exact string in a file |
| 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 installRun
npm run testto run testsBuild with
npm run build
Releases
Versions follow the semantic versioning spec.
To release:
Use
npm version <major | minor | patch>to bump the versionRun
git push --follow-tagsto push with tagsWait for GitHub Actions to publish to the NPM registry.