MCP server enabling AI agents to manage LocalStack local AWS environments via lifecycle, deployment, logs, fault injection, and state management.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Start, stop, and monitor LocalStack AWS emulation containers
Deploy infrastructure projects using Terraform, CDK, or SAM locally
Analyze LocalStack logs to identify errors and generate IAM policies
Inject latency or faults into AWS service mocks to test retry logic
Manage LocalStack state snapshots and import/export workflows
Key features
Lifecycle management of LocalStack runtime with authentication
Automatic detection and deployment of infrastructure as code projects
Natural language search of LocalStack documentation and guides
Log parsing and automated IAM policy generation from errors
Chaos fault and network effect injection into LocalStack services
State management via Cloud Pods and file-based export/import
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Localstack MCP Server.
Extracted Tool Capabilities
Lifecycle management of LocalStack runtime with authentication
Automatic detection and deployment of infrastructure as code projects
Natural language search of LocalStack documentation and guides
Log parsing and automated IAM policy generation from errors
Chaos fault and network effect injection into LocalStack services
State management via Cloud Pods and file-based export/import
Documentation Overview
LocalStack MCP Server
Let an AI agent manage and interact with LocalStack on your machine.
[!IMPORTANT] The LocalStack MCP server is currently available as an experimental public preview. For questions, issues or feedback, please utilize the LocalStack Community slack or submit a GitHub Issue
LocalStack emulates the cloud on your local machine so software teams and AI agents can validate security, quality, and reliability faster and more safely than the cloud allows. This Model Context Protocol (MCP) server lets any MCP client (Cursor, Claude, VS Code, and more) start LocalStack, deploy infrastructure, and debug your local cloud in natural language.
Quick start
Set up the server in your MCP client with the interactive wizard:
The wizard detects your installed clients, asks how you want to run the server, and writes the configuration for you. You need a LocalStack Auth Token; the wizard reads LOCALSTACK_AUTH_TOKEN from your environment or asks for it. For the full options, prerequisites, and manual setup, see Installation.
What you can ask your agent
Once the server is configured, talk to LocalStack through your agent in natural language:
- "Start LocalStack and deploy the Terraform project in
./infra, then tell me which resources came up." - "My Lambda calls are failing. Read the LocalStack logs, find the permission errors, and generate an IAM policy that fixes them."
- "Inject 500ms of latency into DynamoDB and confirm my retry logic still works."
- "Search the LocalStack docs for how to enable S3 event notifications and summarize the steps."
How it works
The server connects MCP-compatible apps directly to your local LocalStack environment and its emulated AWS services, so your assistant can operate the stack securely without custom scripts or manual setup.
This server eliminates custom scripts and manual LocalStack management. Your agent can:
- Start, stop, restart, and monitor LocalStack for AWS container status with built-in auth.
- Deploy CDK, Terraform, and SAM projects with automatic configuration detection.
- Search LocalStack documentation for guides, API references, and configuration details.
- Parse logs, catch errors, and auto-generate IAM policies from violations.
- Inject chaos faults and network effects into LocalStack to test system resilience.
- Manage LocalStack state snapshots via Cloud Pods for development workflows.
- Export, import, inspect, and reset LocalStack state locally with Export & Import State file-based workflows.
- Install, remove, list, and discover LocalStack Extensions from the marketplace.
- Launch and manage Ephemeral Instances for remote LocalStack testing workflows.
- Replicate external AWS resources into LocalStack with AWS Replicator so IaC stacks can resolve shared dependencies locally.
- Inspect LocalStack application flows with App Inspector traces, spans, events, payload metadata, and IAM policy evaluations.
- Start repeatable LocalStack workflows from ready-made MCP prompts, including infrastructure validation and integration test generation.
Tools
This server provides your AI with dedicated tools for managing your LocalStack environment:
[!NOTE] All tools in this MCP server require
LOCALSTACK_AUTH_TOKEN.
| Tool Name | Description | Key Features |
|---|---|---|
localstack-management | Manages LocalStack runtime operations for AWS and Snowflake stacks | - Execute start, stop, restart, and status checks - Integrate LocalStack authentication tokens - Inject custom environment variables - Verify real-time status and perform health monitoring |
localstack-deployer | Handles infrastructure deployment to LocalStack for AWS environments | - Automatically run CDK, Terraform, and SAM tooling to deploy infrastructure locally - Enable parameterized deployments with variable support - Process and present deployment results - Requires you to have cdklocal, tflocal, or samlocal installed in your system path |
localstack-logs-analysis | Analyzes LocalStack for AWS logs for troubleshooting and insights | - Offer multiple analysis options including summaries, errors, requests, and raw data - Filter by specific services and operations - Generate API call metrics and failure breakdowns - Group errors intelligently and identify patterns |
localstack-iam-policy-analyzer | Handles IAM policy management and violation remediation | - Set IAM enforcement levels including enforced, soft, and disabled modes- Search logs for permission-related violations - Generate IAM policies automatically from detected access failures - Requires a valid LocalStack Auth Token |
localstack-chaos-injector | Injects and manages chaos experiment faults for system resilience testing | - Inject, add, remove, and clear service fault rules - Configure network latency effects - Comprehensive fault targeting by service, region, and operation - Built-in workflow guidance for chaos experiments - Requires a valid LocalStack Auth Token |
localstack-cloud-pods | Manages remote LocalStack Cloud Pods for development workflows | - Save current state as a Cloud Pod - Load previously saved Cloud Pods instantly - Delete Cloud Pods from remote cloud-backed storage - Use this for managed remote state snapshots, not local export/import files - Requires a valid LocalStack Auth Token |
localstack-state-management | Manages local file-based LocalStack state export/import workflows | - Export LocalStack state to a local file on disk through the LocalStack State REST API - Import LocalStack state from a local file - Inspect current LocalStack state as JSON metamodel data - Reset all state or only selected services - Supports service-level granularity for export, reset, and inspect - Use this for local disk workflows; use Cloud Pods for remote cloud-backed snapshots - Requires a valid LocalStack Auth Token |
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
27
Stargazers on the source repository.
npm downloads
1.2k
Package downloads in the last 30 days.
Last commit
9d ago
Most recent push to the default branch.
Directory activity
1 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Localstack MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/localstack-localstack-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/localstack-localstack-mcp-server"><img src="https://allmcps.com/api/badge/localstack-localstack-mcp-server?style=directory" alt="Localstack MCP Server on AllMCPs" /></a>Technical Specs & Signals
CategoryCloud Platforms
11/11 checks healthy over the last 32d
56Quality signal: Good · 56/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools22/30
Adoption & activity10/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 15d ago via OSV.dev · @localstack/localstack-mcp-server (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.