Skip to content
MCP server

LocalCloud MCP

Local Google Cloud emulation for coding agents, with 25 services in one Docker container

Runs locallyStatus and history
Install
Pricing
Free
Platforms
macOS, Linux, CLI
Runs
Locally
Version
0.1.12
Listing updated
2 days ago

About LocalCloud MCP

LocalCloud MCP is a free MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "localcloud": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "localcloud": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Free

Free during public preview; free for open-source projects and individual developers

Prices change. Check local.cloud before you buy.

LocalCloud MCP 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 to LocalCloud MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools