Localstack MCP Server
by localstackio.github.localstack/localstack-mcp-serverv0.5.0
Manage LocalStack local AWS environments: lifecycle operations, infrastructure deployments, log analysis, fault injection and state management.
context tax
queued
security
queued
cold start
queued
freshness
Active4d ago
Install Localstack MCP server
Install in Claude Code
claude mcp add localstack -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_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>' -- npx -y @localstack/localstack-mcp-serverInstall in Cursor
{
"mcpServers": {
"localstack": {
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"localstack": {
"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>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"localstack": {
"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 .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"localstack": {
"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.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| LOCALSTACK_AUTH_TOKEN | yes | yes | LocalStack Auth Token (required for all LocalStack MCP tools) |
| AWS_ACCESS_KEY_ID | — | yes | Source AWS access key used by AWS Replicator to read external AWS resources |
| AWS_SECRET_ACCESS_KEY | — | yes | Source AWS secret access key used by AWS Replicator to read external AWS resources |
| AWS_SESSION_TOKEN | — | yes | Optional source AWS session token used by AWS Replicator for temporary credentials |
| AWS_DEFAULT_REGION | — | — | Source AWS region used by AWS Replicator |
| AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID | — | yes | 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 | — | yes | Optional Replicator-specific source AWS secret access key. Use with AWS_REPLICATOR_SOURCE_AWS_ACCESS_KEY_ID. |
| AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN | — | yes | Optional Replicator-specific source AWS session token for temporary credentials. |
| AWS_REPLICATOR_SOURCE_REGION_NAME | — | — | Optional Replicator-specific source AWS region. Use with the AWS_REPLICATOR_SOURCE_* credential group. |
| AWS_REPLICATOR_SOURCE_ENDPOINT_URL | — | — | Optional Replicator-specific source AWS endpoint URL for advanced source-account scenarios. |
| APP_INSPECTOR | — | — | 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. |
Freshness
Active — last maintenance signal 4d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-05 · 4d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-17 · 4mo ago · official registry · v0.5.0
FAQ
›How do I install the Localstack MCP server in Claude Code?
Run: claude mcp add localstack -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_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>' -- npx -y @localstack/localstack-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Localstack require an API key?
Yes. It expects 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, AWS_REPLICATOR_SOURCE_AWS_SESSION_TOKEN, of which 7 are secrets.
›Can I use Localstack as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Localstack in the official MCP registry?
Yes, as io.github.localstack/localstack-mcp-server.
Alternatives to Localstack
Other cloud platforms MCP servers.
ScraplingActiveWeb scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Plg HandlerActiveRemote storage access: SFTP, S3, FTP, SMB, NFS, WebDAV, Git, FTPS, Google Cloud, Azure Blob, SharePoint and more.
CorsairdevActiveMCP server and framework adapters for Corsair. Expose 200+ integrations to any agent framework (Mastra, LangChain, LlamaIndex, OpenAI, Vercel AI, Claude) as tools.
AWS DocumentationActiveFetch, convert, and search AWS documentation pages, with recommendations for related content.AwslabsActiveSuite of servers for integrating with AWS services and resources.CdkActiveGet prescriptive CDK advice, explain CDK Nag rules, check suppressions, generate Bedrock Agent schemas, and discover AWS Solutions Constructs patterns.