filesystem-mcp (via mcp2cli)
Read, write, edit, move, and search files and directories via CLI.
Shortcuts
mcp2cli filesystem <cmd>(alias formcp2cli filesystem-mcp)
Commands
File
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli filesystem file get | Read text file contents | mcp2cli filesystem file get --path /path/to/file.txtmcp2cli filesystem file get --path /path/to/file.txt --head 50 | ref |
mcp2cli filesystem file write | Create or overwrite a file | mcp2cli filesystem file write --path /path/to/file.txt --content 'Hello World' | ref |
mcp2cli filesystem file edit | Make line-based edits to a file | mcp2cli filesystem file edit --path /path/to/file.txt --edits '[{"oldText":"foo","newText":"bar"}]' | ref |
mcp2cli filesystem file search | Search files by glob pattern | mcp2cli filesystem file search --path /project --pattern '**/*.py' | ref |
mcp2cli filesystem file get-multiple | Read multiple files at once | mcp2cli filesystem file get-multiple --paths '["file1.txt","file2.txt"]' | ref |
mcp2cli filesystem file get-media | Read image/audio as base64 | mcp2cli filesystem file get-media --path /path/to/image.png | ref |
mcp2cli filesystem file move | Move or rename a file | mcp2cli filesystem file move --source /old/path --destination /new/path | ref |
mcp2cli filesystem file info | Get file metadata | mcp2cli filesystem file info --path /path/to/file.txt | ref |
Directory
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli filesystem directory create | Create a directory | mcp2cli filesystem directory create --path /new/dir | ref |
mcp2cli filesystem directory list | List directory contents | mcp2cli filesystem directory list --path /project | ref |
mcp2cli filesystem directory tree | Get recursive directory tree | mcp2cli filesystem directory tree --path /project | ref |
mcp2cli filesystem directory list-sizes | List with size information | mcp2cli filesystem directory list-sizes --path /project | ref |
mcp2cli filesystem directory list-allowed | List accessible directories | mcp2cli filesystem directory list-allowed | ref |
Discover Parameters
Append --help to any command for full parameter list:
mcp2cli filesystem file get --help
Note: Use Ref links in the Commands table above to view detailed parameter reference and more examples.
User Notes
MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in
~/.agents/mcp2cli/servers.yaml- edit there to take effect.


