LocalStack MCP Server

Name: LocalStack MCP Server
Author: LocalStack

LocalStackOfficial

Manages local LocalStack AWS environments: start and stop the emulator, deploy infrastructure, analyze logs, inject faults and manage state.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add localstack --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

~/.codex/config.toml

[mcp_servers.localstack]
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>" }

# codex mcp add localstack --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

~/.cursor/mcp.json

{
  "mcpServers": {
    "localstack": {
      "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>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "localstack": {
      "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>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "localstack": {
      "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>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "localstack": {
      "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>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "localstack": {
      "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>"
      }
    }
  }
}

Environment variables

LOCALSTACK_AUTH_TOKEN
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
AWS_SESSION_TOKEN
AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID
AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY
AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related