Skip to content
MCP server

Localstack MCP Server

A LocalStack MCP Server providing essential tools for local cloud development & testing

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.5.0
Listing updated
5 days ago

About Localstack MCP Server

Localstack MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add localstack-mcp-server --env LOCALSTACK_AUTH_TOKEN='<LOCALSTACK_AUTH_TOKEN>' --env AWS_ACCESS_KEY_ID='<AWS_ACCESS_KEY_ID>' --env AWS_SECRET_ACCESS_KEY='<AWS_SECRET_ACCESS_KEY>' --env AWS_SESSION_TOKEN='<AWS_SESSION_TOKEN>' --env AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID='<AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID>' --env AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY='<AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY>' --env AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN='<AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN>' -- npx -y @localstack/localstack-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "localstack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@localstack/localstack-mcp-server"
      ],
      "env": {
        "LOCALSTACK_AUTH_TOKEN": "<LOCALSTACK_AUTH_TOKEN>",
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AWS_SESSION_TOKEN": "<AWS_SESSION_TOKEN>",
        "AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID": "<AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID>",
        "AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY": "<AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY>",
        "AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN": "<AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "localstack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@localstack/localstack-mcp-server"
      ],
      "env": {
        "LOCALSTACK_AUTH_TOKEN": "<LOCALSTACK_AUTH_TOKEN>",
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AWS_SESSION_TOKEN": "<AWS_SESSION_TOKEN>",
        "AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID": "<AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID>",
        "AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY": "<AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY>",
        "AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN": "<AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "localstack-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@localstack/localstack-mcp-server"
      ],
      "env": {
        "LOCALSTACK_AUTH_TOKEN": "<LOCALSTACK_AUTH_TOKEN>",
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AWS_SESSION_TOKEN": "<AWS_SESSION_TOKEN>",
        "AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID": "<AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID>",
        "AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY": "<AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY>",
        "AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN": "<AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "localstack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@localstack/localstack-mcp-server"
      ],
      "env": {
        "LOCALSTACK_AUTH_TOKEN": "<LOCALSTACK_AUTH_TOKEN>",
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AWS_SESSION_TOKEN": "<AWS_SESSION_TOKEN>",
        "AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID": "<AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID>",
        "AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY": "<AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY>",
        "AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN": "<AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "localstack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@localstack/localstack-mcp-server"
      ],
      "env": {
        "LOCALSTACK_AUTH_TOKEN": "<LOCALSTACK_AUTH_TOKEN>",
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AWS_SESSION_TOKEN": "<AWS_SESSION_TOKEN>",
        "AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID": "<AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID>",
        "AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY": "<AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY>",
        "AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN": "<AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • LOCALSTACK_AUTH_TOKENLocalStack Auth Token (required for all LocalStack MCP tools)Required
  • AWS_ACCESS_KEY_IDSource AWS access key used by AWS Replicator to read external AWS resources
  • AWS_SECRET_ACCESS_KEYSource AWS secret access key used by AWS Replicator to read external AWS resources
  • AWS_SESSION_TOKENOptional source AWS session token used by AWS Replicator for temporary credentials
  • AWS_DEFAULT_REGIONSource AWS region used by AWS Replicator
  • AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_IDOptional Replicator-specific source AWS access key. Use this instead of AWS_ACCESS_KEY_ID when the Replicator source account should be isolated from generic AWS config.
  • AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEYOptional Replicator-specific source AWS secret access key. Use with AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID.
  • AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKENOptional Replicator-specific source AWS session token for temporary credentials.
  • AWS_REPLICATOR_SOURCE_REGION_NAMEOptional Replicator-specific source AWS region. Use with the AWS_REPLICATOR_SOURCE_* credential group.
  • AWS_REPLICATOR_SOURCE_ENDPOINT_URLOptional Replicator-specific source AWS endpoint URL for advanced source-account scenarios.
  • APP_INSPECTORSet 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.

Pricing

Open source

Localstack MCP Server FAQ

Is Localstack MCP Server free?

Yes. Localstack MCP Server is open source, so you can use and self-host it for free.

How do I add Localstack MCP Server to Claude Code?

Run this command in your terminal: claude mcp add localstack-mcp-server --env LOCALSTACK_AUTH_TOKEN='<LOCALSTACK_AUTH_TOKEN>' --env AWS_ACCESS_KEY_ID='<AWS_ACCESS_KEY_ID>' --env AWS_SECRET_ACCESS_KEY='<AWS_SECRET_ACCESS_KEY>' --env AWS_SESSION_TOKEN='<AWS_SESSION_TOKEN>' --env AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID='<AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID>' --env AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY='<AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY>' --env AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN='<AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN>' -- npx -y @localstack/localstack-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers