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

Install

Claude DesktopClaude CodeCursor

Paste into 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>"
      }
    }
  }
}

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

Paste into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "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>"
      }
    }
  }
}

Transport & auth

Transport: stdio - Runs locally over stdio. Your client launches the process itself; you need the matching runtime installed (Node for npx, uv for uvx, Docker for docker run).

Auth: requires credentials - replace the <PLACEHOLDER> environment values in the config with your own keys (see the vendor's docs).

io.github.localstack/localstack-mcp-server

Install

Transport & auth

Links