Localstack MCP Server
A LocalStack MCP Server providing essential tools for local cloud development & testing
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.5.0
- Listing updated
- 5 days ago
About Localstack MCP Server
Localstack MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
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-serverAdd to 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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"localstack-mcp-server": {
"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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
LOCALSTACK_AUTH_TOKENLocalStack Auth Token (required for all LocalStack MCP tools)RequiredAWS_ACCESS_KEY_IDSource AWS access key used by AWS Replicator to read external AWS resourcesAWS_SECRET_ACCESS_KEYSource AWS secret access key used by AWS Replicator to read external AWS resourcesAWS_SESSION_TOKENOptional source AWS session token used by AWS Replicator for temporary credentialsAWS_DEFAULT_REGIONSource AWS region used by AWS ReplicatorAWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_IDOptional 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_KEYOptional Replicator-specific source AWS secret access key. Use with AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID.AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKENOptional Replicator-specific source AWS session token for temporary credentials.AWS_REPLICATOR_SOURCE_REGION_NAMEOptional Replicator-specific source AWS region. Use with the AWS_REPLICATOR_SOURCE_* credential group.AWS_REPLICATOR_SOURCE_ENDPOINT_URLOptional Replicator-specific source AWS endpoint URL for advanced source-account scenarios.APP_INSPECTORSet 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.
Pricing
Open source
Localstack MCP Server FAQ
Is Localstack MCP Server free?
Yes. Localstack MCP Server is open source, so you can use and self-host it for free.
How do I add Localstack MCP Server to Claude Code?
Run this command in your 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
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.