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.