Connect ChatGPT to your local filesystem in 60 seconds. One-command MCP server with automatic HTTPS tunnel for ChatGPT Developer Mode.
npm install local-mcp-filesystemConnect ChatGPT to your local filesystem in one command.
---
``bashRun directly (no install needed)
npx local-mcp-filesystem
That's it! The command will:
1. Start the filesystem adapter
2. Create a secure tunnel
3. Give you an HTTPS URL to paste into ChatGPT
After running:
1. Copy the tunnel URL (e.g.,
)
2. Add to ChatGPT Settings → Apps & Connectors → Developer Mode
3. Add name 'Local Filesystem' (or whatever you like)
4. Set Protocol: HTTP (streaming)
5. Set Authentication: None
6. Refresh ChatGPT and ask it to work with your files---
Configuration
$3
| Option | Alias | Description | Default |
|--------|-------|-------------|---------|
|
--port | -p | Adapter port | 3000 |
| --dir | -d | Root directory to serve | Current directory |
| --tunnel-url | -t | Use existing tunnel (skip creation) | Auto-create |
| --dev | | Development mode (verbose logs) | false |
| --help | -h | Show help | |$3
`bash
Start in current directory
npx local-mcp-filesystemServe a specific directory
npx local-mcp-filesystem --dir ~/DocumentsUse custom port
npx local-mcp-filesystem --port 3001Short alias
npx lmcp
`---
Available Tools
Once connected, ChatGPT can:
- read_file / read_text_file - Read file contents
- write_file - Create or update files
- list_directory - List directory contents
- search_files - Find files by pattern
- get_file_info - Get file metadata
- create_directory - Create new directories
- move_file - Move or rename files
ChatGPT will automatically use these tools when you ask it to work with files.
---
Security
$3
- ✅ Only files in the specified
(default: current directory)
- ✅ Respects .gitignore patterns
- ❌ Cannot access files outside root directory
- ❌ Cannot execute commands$3
- Tunnel URL is temporary (expires when you stop the process)
- Only accessible while the process is running
- No authentication needed (secured by temporary URL)
$3
`bash
✅ Good: Specific project directory
npx local-mcp-filesystem --dir ~/projects/my-app❌ Bad: Root or home directory
npx local-mcp-filesystem --dir ~ # Too broad!
npx local-mcp-filesystem --dir / # Dangerous!
`---
Requirements
- Node.js >= 18.19
- Cloudflared - Automatically installed via npm dependency
---
Troubleshooting
$3
Port 3000 is taken. Use a different port:
bash
npx local-mcp-filesystem --port 3001
``1. Check the tunnel URL is correct
2. Verify the server is running (don't close terminal)
3. Try refreshing ChatGPT's connector
The process runs with your user permissions. If you can't read a file, neither can the server.
---
MIT - Built for the MCP community.
Need help? Open an issue or read CLAUDE.md for technical details.