# Remote Filesystem MCP server

> Lets an AI client upload, download, list, modify, and delete files in Google Cloud Storage buckets.

- Repository: https://github.com/pulsemcp/mcp-servers
- Page: https://hostedmcp.org/servers/pulsemcp/remote-filesystem
- Official: yes
- Transport: stdio
- Stars: 81
- License: MIT
- Latest version: 0.1.5

## Install

### Claude Code

```sh
claude mcp add --env 'GCS_BUCKET=<GCS_BUCKET>' --env 'GCS_PRIVATE_KEY=<YOUR_GCS_PRIVATE_KEY>' remote-filesystem -- npx -y remote-filesystem-mcp-server
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "remote-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "remote-filesystem-mcp-server"
      ],
      "env": {
        "GCS_BUCKET": "<GCS_BUCKET>",
        "GCS_PRIVATE_KEY": "<YOUR_GCS_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "remote-filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "remote-filesystem-mcp-server"
      ],
      "env": {
        "GCS_BUCKET": "<GCS_BUCKET>",
        "GCS_PRIVATE_KEY": "<YOUR_GCS_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"remote-filesystem","type":"stdio","command":"npx","args":["-y","remote-filesystem-mcp-server"],"env":{"GCS_BUCKET":"<GCS_BUCKET>","GCS_PRIVATE_KEY":"<YOUR_GCS_PRIVATE_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "remote-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "remote-filesystem-mcp-server"
      ],
      "env": {
        "GCS_BUCKET": "<GCS_BUCKET>",
        "GCS_PRIVATE_KEY": "<YOUR_GCS_PRIVATE_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add remote-filesystem --env 'GCS_BUCKET=<GCS_BUCKET>' --env 'GCS_PRIVATE_KEY=<YOUR_GCS_PRIVATE_KEY>' -- npx -y remote-filesystem-mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.remote-filesystem]
command = "npx"
args = ["-y", "remote-filesystem-mcp-server"]

[mcp_servers.remote-filesystem.env]
GCS_BUCKET = "<GCS_BUCKET>"
GCS_PRIVATE_KEY = "<YOUR_GCS_PRIVATE_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'GCS_BUCKET=<GCS_BUCKET>' -e 'GCS_PRIVATE_KEY=<YOUR_GCS_PRIVATE_KEY>' remote-filesystem npx -- -y remote-filesystem-mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "remote-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "remote-filesystem-mcp-server"
      ],
      "env": {
        "GCS_BUCKET": "<GCS_BUCKET>",
        "GCS_PRIVATE_KEY": "<YOUR_GCS_PRIVATE_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GCS_BUCKET` | yes | no | Google Cloud Storage bucket name. |
| `GCS_PRIVATE_KEY` | no | yes | Service account private key for inline credentials. |
| `ENABLED_TOOLGROUPS` | no | no | Comma-separated tool groups: readonly or readwrite. |
| `GCS_CLIENT_EMAIL` | no | no | Service account email for inline credentials. |
| `GCS_MAKE_PUBLIC` | no | no | Make uploaded files publicly accessible. |
| `GCS_PROJECT_ID` | no | no | Google Cloud project ID. |
| `GCS_ROOT_PATH` | no | no | Root path prefix to restrict access within bucket. |
| `GOOGLE_APPLICATION_CREDENTIALS` | no | no | Path to Google Cloud service account key file. |

## Tools (4)

- `source`
- `path`
- `prefix`
- `metadata`

## FAQ

### Which cloud storage providers does Remote Filesystem MCP support?

It currently supports Google Cloud Storage, with plans for S3, Cloudflare R2, and more.

### How do I authenticate the GCS bucket connection?

You can use inline credentials (client email and private key), a service account key file, or Application Default Credentials.

### Can I restrict access to a subfolder of the bucket?

Yes, set GCS_ROOT_PATH to a root path prefix to restrict access within the bucket.

### Can I limit the server to read-only operations?

Yes, set ENABLED_TOOLGROUPS=readonly so only the download and list_files tools are available.

### Can I download binary files?

Yes, pass asBase64 to the download tool to get binary data returned as base64.
