# Remote Filesystem

> Remote Filesystem is an open-source MCP server for files and documents. MCP server for remote filesystem operations on cloud storage (Google Cloud Storage). It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/pulsemcp/mcp-servers/tree/HEAD/experimental/remote-filesystem
- **MCP Registry name:** com.pulsemcp/remote-filesystem
- **Categories:** files and documents
- **Listing updated:** 2026-11-13

## About

MCP server for remote filesystem operations on cloud storage (Google Cloud Storage).

## Install

### Claude Code (Terminal)

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

### 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": "<GCS_PRIVATE_KEY>"
      }
    }
  }
}
```

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

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### Is Remote Filesystem free?

Yes. Remote Filesystem is open source, so you can use and self-host it for free.

### How do I add Remote Filesystem to Claude Code?

Run this command in your terminal: claude mcp add remote-filesystem --env GCS_BUCKET='<GCS_BUCKET>' --env GCS_PRIVATE_KEY='<GCS_PRIVATE_KEY>' -- npx -y remote-filesystem-mcp-server

### What are the best alternatives to Remote Filesystem?

The closest alternatives to Remote Filesystem are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/remote-filesystem
