# LocalCloud MCP

> LocalCloud MCP is a free MCP server for cloud and infrastructure. Local Google Cloud emulation for coding agents, with 25 services in one Docker container. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** macOS, Linux, CLI
- **Website:** https://local.cloud
- **Repository:** https://github.com/localgcloud/localcloud-cli
- **MCP Registry name:** cloud.local/localcloud
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-15

## About

LocalCloud is a runtime that stands in for Google Cloud on localhost, so an agent can build, test and debug against Storage, Pub/Sub, BigQuery, Spanner and similar APIs without a GCP account, credentials or billing. The MCP server is the LocalCloud CLI used as a stdio server, shipped as an .mcpb bundle, and it gives the agent local services, SDK configuration, test data, readiness checks and diagnostics.

Application code keeps using the official Google client libraries. After starting the runtime, the shell exports the endpoint variables that those libraries already look for. Services are chosen in a localcloud.yaml file; Firestore, GKE and Cloud Run are opt-in. Data persists in a named Docker volume, and separate environments can run side by side, for example one for CI.

Docker must be running. The site and README give slightly different service counts (25 on the site, 27 in the README), so check the service pages for the exact list.

## Features

- **Local Google Cloud APIs:** Run services such as Storage, Pub/Sub, BigQuery and Spanner on loopback ports.
- **Unchanged SDK code:** Point existing Google client libraries at local endpoints through exported environment variables.
- **Persistent volumes:** Keep data between runs in a named Docker volume.
- **Repository guidance:** The site tells agents to read AGENTS.md and match services to what the repo uses.
- **Signed releases:** CLI releases come with Sigstore signatures and SHA-256 checksums.
- **Terraform and CI setup:** Documentation covers SDKs, MCP, Terraform and CI fixtures.

## Good for

- Run integration tests against BigQuery and Pub/Sub without a cloud project
- Let a coding agent debug a Google Cloud app offline
- Give CI runners a throwaway Google Cloud environment
- Try a service locally before paying for it in the cloud

## Install

### Claude Code (Terminal)

```sh
claude mcp add localcloud -- npx -y https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "localcloud": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "localcloud": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "localcloud": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "localcloud": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "localcloud": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
      ]
    }
  }
}
```

## FAQ

### Is it free?

Yes during the public preview, including the Pro-tier services. Free use for open-source projects and individual developers continues after the preview.

### Do I need a Google Cloud account?

No account, credentials or billing are needed for local workflows.

### What does it need?

Docker running and the LocalCloud CLI, installed with brew or the install script.

### Is it for production?

No. The pricing page describes it for non-production development, testing and CI.

### Is LocalCloud MCP free?

Yes. LocalCloud MCP is free to use.

### How do I add LocalCloud MCP to Claude Code?

Run this command in your terminal: claude mcp add localcloud -- npx -y https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb

### What are the best alternatives to LocalCloud MCP?

The closest alternatives to LocalCloud MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/localcloud-mcp
