# filex

MCP server for Claude Code bridges the model with your self-hosted filex instance. It exposes local disks, S3 buckets, SFTP, WebDAV, FTP, and SMB shares to coding agents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 106 repo stars
- Author: BRF-Tech
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/BRF-Tech/filex
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/filex

## What it does

The tool runs directly inside filex, a self-hosted Go file manager. Connected agents browse directories, read files, and transfer data across mounted storages via a unified virtual tree.

Underneath, filex handles storage drivers, folder encryption, trash retention, and identity through LDAP or OIDC. It allows agents to interact with files stored across diverse backends without separate cloud SDKs.

The integration requires an active filex deployment running either as a standalone binary or via the `ghcr.io/brf-tech/filex:latest` Docker container listening on port 5212.

## Requirements
- Needs: a prebuilt binary from the repository releases
- Remote server: `https://{host}/api/ai/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http filex https://{host}/api/ai/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add filex --url https://{host}/api/ai/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "filex": {
            "url": "https://{host}/api/ai/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "filex": {
            "type": "http",
            "url": "https://{host}/api/ai/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http filex https://{host}/api/ai/mcp
```

## When to use it
- provide agents access to files on S3, SFTP, and SMB storage
- read and organize assets across unified server directories
- transfer archives between local disks and remote buckets
- inspect versioned documents stored inside private infrastructure

## Example prompts
- List all files stored in the SFTP reports directory
- Fetch the contents of config.json from the S3 bucket
- Copy the exported dataset from the local storage to the SMB share

## Similar
- [rclone_serve_sftp](https://affpapa.org/en/nevibecode/commands/rclone-serve-sftp.md) — command · ★ 50109 repo stars
- [cli-anything-tigris](https://affpapa.org/en/nevibecode/skills/cli-anything-tigris.md) — skill · 252 installs
- [Backblaze B2 MCP Server](https://affpapa.org/en/nevibecode/mcp/backblaze-b2-mcp-server.md) — MCP server · ★ 48 repo stars
- [troubleshooting-s3-files](https://affpapa.org/en/nevibecode/skills/troubleshooting-s3-files.md) — skill · 7100 installs
- [backup-recovery](https://affpapa.org/en/nevibecode/skills/backup-recovery.md) — skill · 460 installs
- [digitalocean-storage](https://affpapa.org/en/nevibecode/skills/digitalocean-storage.md) — skill · 421 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
