# Localstack MCP Server (MCP server)

> Localstack MCP Server is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. A LocalStack MCP Server providing essential tools for local cloud development & testing. It has 27 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @localstack/localstack-mcp-server.

Let an AI agent manage and interact with LocalStack on your machine. LocalStack emulates the cloud on your local machine so software teams and AI agents can validate security, quality, and reliability faster and more safely than the cloud allows. This Model Context Protocol (MCP) server lets any MCP client (Cursor, Claude, VS Code, and more) start LocalStack, deploy infrastructure, and debug your local cloud in natural language.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/localstack/localstack-mcp-server |
| GitHub stars | 27 |
| License | Apache-2.0 |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @localstack/localstack-mcp-server |
| Remote URL | none |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Cloud & DevOps |
| Latest release | none |
| Last commit | Oct 5, 2026 |
| MCP registry name | io.github.localstack/localstack-mcp-server |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "localstack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@localstack/localstack-mcp-server"
      ],
      "env": {
        "LOCALSTACK_AUTH_TOKEN": "your-value",
        "AWS_ACCESS_KEY_ID": "your-value",
        "AWS_SECRET_ACCESS_KEY": "your-value",
        "AWS_SESSION_TOKEN": "your-value",
        "AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID": "your-value",
        "AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env LOCALSTACK_AUTH_TOKEN=your-value --env AWS_ACCESS_KEY_ID=your-value --env AWS_SECRET_ACCESS_KEY=your-value --env AWS_SESSION_TOKEN=your-value --env AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID=your-value --env AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY=your-value --transport stdio localstack-mcp-server -- npx -y @localstack/localstack-mcp-server
```

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

```json
{
  "mcpServers": {
    "localstack-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@localstack/localstack-mcp-server"
      ],
      "env": {
        "LOCALSTACK_AUTH_TOKEN": "your-value",
        "AWS_ACCESS_KEY_ID": "your-value",
        "AWS_SECRET_ACCESS_KEY": "your-value",
        "AWS_SESSION_TOKEN": "your-value",
        "AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID": "your-value",
        "AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "localstack_auth_token",
      "description": "LOCALSTACK_AUTH_TOKEN",
      "password": true
    },
    {
      "type": "promptString",
      "id": "aws_access_key_id",
      "description": "AWS_ACCESS_KEY_ID",
      "password": true
    },
    {
      "type": "promptString",
      "id": "aws_secret_access_key",
      "description": "AWS_SECRET_ACCESS_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "aws_session_token",
      "description": "AWS_SESSION_TOKEN",
      "password": true
    },
    {
      "type": "promptString",
      "id": "aws_replicator_source_aws_access_key_id",
      "description": "AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID",
      "password": true
    },
    {
      "type": "promptString",
      "id": "aws_replicator_source_aws_secret_access_key",
      "description": "AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY",
      "password": true
    }
  ],
  "servers": {
    "localstack-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@localstack/localstack-mcp-server"
      ],
      "env": {
        "LOCALSTACK_AUTH_TOKEN": "${input:localstack_auth_token}",
        "AWS_ACCESS_KEY_ID": "${input:aws_access_key_id}",
        "AWS_SECRET_ACCESS_KEY": "${input:aws_secret_access_key}",
        "AWS_SESSION_TOKEN": "${input:aws_session_token}",
        "AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID": "${input:aws_replicator_source_aws_access_key_id}",
        "AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY": "${input:aws_replicator_source_aws_secret_access_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `LOCALSTACK_AUTH_TOKEN` (secret) (required): LocalStack Auth Token (required for all LocalStack MCP tools)
- `AWS_ACCESS_KEY_ID` (secret): Source AWS access key used by AWS Replicator to read external AWS resources
- `AWS_SECRET_ACCESS_KEY` (secret): Source AWS secret access key used by AWS Replicator to read external AWS resources
- `AWS_SESSION_TOKEN` (secret): Optional source AWS session token used by AWS Replicator for temporary credentials
- `AWS_DEFAULT_REGION`: Source AWS region used by AWS Replicator
- `AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID` (secret): Optional Replicator-specific source AWS access key. Use this instead of AWSACCESSKEY_ID when the Replicator source account should be isolated from generic AWS…
- `AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY` (secret): Optional Replicator-specific source AWS secret access key. Use with AWSREPLICATORSOURCEAWSACCESSKEYID.
- `AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN` (secret): Optional Replicator-specific source AWS session token for temporary credentials.
- `AWS_REPLICATOR_SOURCE_REGION_NAME`: Optional Replicator-specific source AWS region. Use with the AWSREPLICATORSOURCE_* credential group.
- `AWS_REPLICATOR_SOURCE_ENDPOINT_URL`: Optional Replicator-specific source AWS endpoint URL for advanced source-account scenarios.
- `APP_INSPECTOR`: Set to 1 in the LocalStack container environment to enable App Inspector by default across restarts. The MCP tool can also toggle App Inspector at runtime.

## Similar MCP servers

- [Worldmonitor](https://appsgit.com/mcp-servers/worldmonitor): Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface. (87,920 stars, AGPL-3.0)
- [Netdata](https://appsgit.com/mcp-servers/netdata): Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection. (80,817 stars, GPL-3.0, needs API key)
- [openstatus](https://appsgit.com/mcp-servers/openstatus): Manage monitors, status pages, incidents and maintenances in your openstatus workspace. (9,171 stars, AGPL-3.0, official)
- [MCP Server Cloudflare](https://appsgit.com/mcp-servers/mcp-server-cloudflare): Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. (4,360 stars, Apache-2.0, official, needs API key)
- [Dagu](https://appsgit.com/mcp-servers/dagu): Self-hostable workflow orchestrator for teams whose main work isn't orchestration. (4,289 stars, GPL-3.0)
- [Azure MCP Server](https://appsgit.com/mcp-servers/azure-mcp-server): All Azure MCP tools to create a seamless connection between AI agents and Azure services. (3,738 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/localstack-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
