Skip to content
appsgit

Localstack 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.

github.com/localstack/localstack-mcp-server (opens in a new tab)

View on GitHub (opens in a new tab)

Install Localstack MCP Server

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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
{
  "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
{
  "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 Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
LOCALSTACK_AUTH_TOKENsecretYesLocalStack Auth Token (required for all LocalStack MCP tools)
AWS_ACCESS_KEY_IDsecretNoSource AWS access key used by AWS Replicator to read external AWS resources
AWS_SECRET_ACCESS_KEYsecretNoSource AWS secret access key used by AWS Replicator to read external AWS resources
AWS_SESSION_TOKENsecretNoOptional source AWS session token used by AWS Replicator for temporary credentials
AWS_DEFAULT_REGIONNoSource AWS region used by AWS Replicator
AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_IDsecretNoOptional 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_KEYsecretNoOptional Replicator-specific source AWS secret access key. Use with AWSREPLICATORSOURCEAWSACCESSKEYID.
AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKENsecretNoOptional Replicator-specific source AWS session token for temporary credentials.
AWS_REPLICATOR_SOURCE_REGION_NAMENoOptional Replicator-specific source AWS region. Use with the AWSREPLICATORSOURCE_* credential group.
AWS_REPLICATOR_SOURCE_ENDPOINT_URLNoOptional Replicator-specific source AWS endpoint URL for advanced source-account scenarios.
APP_INSPECTORNoSet 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.

About 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.

Similar MCP servers

More cloud & devops MCP servers

All Cloud & DevOps

FAQ

Localstack MCP Server FAQ

Still curious? Email info@appsgit.com.

What is Localstack 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. The source code is at github.com/localstack/localstack-mcp-server.

How do I install the Localstack MCP Server MCP server?

Add the command npx -y @localstack/localstack-mcp-server to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Localstack MCP Server free?

The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (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 and AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN) for the service it connects to, which may require a paid account.

Is Localstack MCP Server actively maintained?

The most recent commit was on Oct 5, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.