# Localstack

> Localstack is an open-source MCP server. MCP server for LocalStack AWS services, enabling AI agents to interact with local AWS infra. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/giovanemartins/localstack-mcp-server
- **MCP Registry name:** io.github.giovanemartins/localstack
- **Listing updated:** 2026-11-13

## About

MCP server for LocalStack AWS services, enabling AI agents to interact with local AWS infra.

## Install

### Claude Code (Terminal)

```sh
claude mcp add localstack --env AWS_ACCESS_KEY_ID='<AWS_ACCESS_KEY_ID>' --env AWS_SECRET_ACCESS_KEY='<AWS_SECRET_ACCESS_KEY>' -- npx -y @giovane.martins/localstack
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "localstack": {
      "command": "npx",
      "args": [
        "-y",
        "@giovane.martins/localstack"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "localstack": {
      "command": "npx",
      "args": [
        "-y",
        "@giovane.martins/localstack"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "localstack": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@giovane.martins/localstack"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "localstack": {
      "command": "npx",
      "args": [
        "-y",
        "@giovane.martins/localstack"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "localstack": {
      "command": "npx",
      "args": [
        "-y",
        "@giovane.martins/localstack"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

## FAQ

### Is Localstack free?

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

### How do I add Localstack to Claude Code?

Run this command in your terminal: claude mcp add localstack --env AWS_ACCESS_KEY_ID='<AWS_ACCESS_KEY_ID>' --env AWS_SECRET_ACCESS_KEY='<AWS_SECRET_ACCESS_KEY>' -- npx -y @giovane.martins/localstack

## Where this comes from

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

---
Source: https://ai-powered.com/mcp/localstack
