MCP server that exposes LocalStack-managed AWS services as AI-agent tools, enabling LLMs and AI agents to interact with local AWS infrastructure during development and testing.
Setup
Choose your client, copy the config, then fill in any required environment variables.
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~/.codex/config.toml
[mcp_servers.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>" }
# codex 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~/.cursor/mcp.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>"
}
}
}
}.vscode/mcp.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>"
}
}
}
}~/.gemini/settings.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>"
}
}
}
}claude_desktop_config.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>"
}
}
}
}.trae/mcp.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>"
}
}
}
}Environment variables
AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY
Replace the placeholders with your own credentials and keep them out of version control.