Localstack Mcp Server

io.github.localstack/localstack-mcp-server · v0.5.0

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

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add localstack-mcp-server -e LOCALSTACK_AUTH_TOKEN=<LOCALSTACK_AUTH_TOKEN> -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -e AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN> -e AWS_DEFAULT_REGION=<AWS_DEFAULT_REGION> -e AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID=<AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID> -e AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY=<AWS_REPLICATOR_SOURCE_AWS_SECRET_ACCESS_KEY> -e AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN=<AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN> -e AWS_REPLICATOR_SOURCE_REGION_NAME=<AWS_REPLICATOR_SOURCE_REGION_NAME> -e AWS_REPLICATOR_SOURCE_ENDPOINT_URL=<AWS_REPLICATOR_SOURCE_ENDPOINT_URL> -e APP_INSPECTOR=<APP_INSPECTOR> -- npx -y @localstack/[email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "localstack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@localstack/[email protected]"
      ],
      "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_DEFAULT_REGION": "<AWS_DEFAULT_REGION>",
        "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>",
        "AWS_REPLICATOR_SOURCE_REGION_NAME": "<AWS_REPLICATOR_SOURCE_REGION_NAME>",
        "AWS_REPLICATOR_SOURCE_ENDPOINT_URL": "<AWS_REPLICATOR_SOURCE_ENDPOINT_URL>",
        "APP_INSPECTOR": "<APP_INSPECTOR>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "localstack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@localstack/[email protected]"
      ],
      "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_DEFAULT_REGION": "<AWS_DEFAULT_REGION>",
        "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>",
        "AWS_REPLICATOR_SOURCE_REGION_NAME": "<AWS_REPLICATOR_SOURCE_REGION_NAME>",
        "AWS_REPLICATOR_SOURCE_ENDPOINT_URL": "<AWS_REPLICATOR_SOURCE_ENDPOINT_URL>",
        "APP_INSPECTOR": "<APP_INSPECTOR>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "localstack-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@localstack/[email protected]"
      ],
      "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_DEFAULT_REGION": "<AWS_DEFAULT_REGION>",
        "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>",
        "AWS_REPLICATOR_SOURCE_REGION_NAME": "<AWS_REPLICATOR_SOURCE_REGION_NAME>",
        "AWS_REPLICATOR_SOURCE_ENDPOINT_URL": "<AWS_REPLICATOR_SOURCE_ENDPOINT_URL>",
        "APP_INSPECTOR": "<APP_INSPECTOR>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`LOCALSTACK_AUTH_TOKEN` Required, secret	LocalStack Auth Token (required for all LocalStack MCP tools)
`AWS_ACCESS_KEY_ID` Optional, secret	Source AWS access key used by AWS Replicator to read external AWS resources
`AWS_SECRET_ACCESS_KEY` Optional, secret	Source AWS secret access key used by AWS Replicator to read external AWS resources
`AWS_SESSION_TOKEN` Optional, secret	Optional source AWS session token used by AWS Replicator for temporary credentials
`AWS_DEFAULT_REGION` Optional	Source AWS region used by AWS Replicator
`AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID` Optional, secret	Optional 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_KEY` Optional, secret	Optional Replicator-specific source AWS secret access key. Use with AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID.
`AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN` Optional, secret	Optional Replicator-specific source AWS session token for temporary credentials.
`AWS_REPLICATOR_SOURCE_REGION_NAME` Optional	Optional Replicator-specific source AWS region. Use with the AWS_REPLICATOR_SOURCE_* credential group.
`AWS_REPLICATOR_SOURCE_ENDPOINT_URL` Optional	Optional Replicator-specific source AWS endpoint URL for advanced source-account scenarios.
`APP_INSPECTOR` Optional	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.

Details

Package	`@localstack/[email protected]` (NPM, stdio)
First published	17 Jun 2026
Last updated	17 Jun 2026
Registry name	`io.github.localstack/localstack-mcp-server`

More developer tools servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Localstack Mcp Server often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-localstack-localstack-mcp-server/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-localstack-localstack-mcp-server)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.