giovanemartins avatar

Localstack

giovanemartins/localstack-mcp-server

Connects Claude to LocalStack so you can manage local AWS infrastructure without leaving your conversation. You get tools for S3 bucket operations, SQS/SNS messaging, DynamoDB CRUD, Lambda invocations with logs, EventBridge rules and event publishing, Kinesis streams, Secrets Manager, SSM Parameter Store, and SES email sending. Useful when you're bootstrapping dev environments, seeding test data, debugging event driven workflows, or iterating on Lambda functions locally. Everything runs against LocalStack's Docker container on localhost:4566 with fake credentials. The npm package works with npx so there's no install ceremony, and all AWS services stay contained in your local environment.

GitHub stars
1
tools
73
auth
Secret needed
transport
STDIO
env vars
4
last updated
Mar 8, 2026

Tools

73 tools

Public tool metadata for what this MCP can expose to an agent.

s3_list_bucketsList all S3 buckets

List all S3 buckets

No parameter schema in public metadata yet.

s3_create_bucketCreate a bucket

Create a bucket

No parameter schema in public metadata yet.

s3_delete_bucketDelete a bucket

Delete a bucket

No parameter schema in public metadata yet.

s3_put_objectUpload an object (text/JSON content)

Upload an object (text/JSON content)

No parameter schema in public metadata yet.

s3_get_objectDownload an object as text

Download an object as text

No parameter schema in public metadata yet.

s3_delete_objectDelete an object

Delete an object

No parameter schema in public metadata yet.

s3_list_objectsList objects with optional prefix filter

List objects with optional prefix filter

No parameter schema in public metadata yet.

sqs_list_queuesList all queues

List all queues

No parameter schema in public metadata yet.

sqs_create_queueCreate a standard or FIFO queue

Create a standard or FIFO queue

No parameter schema in public metadata yet.

sqs_delete_queueDelete a queue

Delete a queue

No parameter schema in public metadata yet.

sqs_send_messageSend a message

Send a message

No parameter schema in public metadata yet.

sqs_receive_messagesReceive up to 10 messages (with long-polling support)

Receive up to 10 messages (with long-polling support)

No parameter schema in public metadata yet.

sqs_delete_messageDelete a message by receipt handle

Delete a message by receipt handle

No parameter schema in public metadata yet.

sqs_purge_queuePurge all messages from a queue

Purge all messages from a queue

No parameter schema in public metadata yet.

sns_list_topicsList all topics

List all topics

No parameter schema in public metadata yet.

sns_create_topicCreate a standard or FIFO topic

Create a standard or FIFO topic

No parameter schema in public metadata yet.

sns_delete_topicDelete a topic

Delete a topic

No parameter schema in public metadata yet.

sns_subscribeSubscribe an endpoint to a topic

Subscribe an endpoint to a topic

No parameter schema in public metadata yet.

sns_unsubscribeUnsubscribe from a topic

Unsubscribe from a topic

No parameter schema in public metadata yet.

sns_list_subscriptions_by_topicList all subscriptions for a topic

List all subscriptions for a topic

No parameter schema in public metadata yet.

sns_publishPublish a message to a topic

Publish a message to a topic

No parameter schema in public metadata yet.

eventbridge_list_busesList all event buses

List all event buses

No parameter schema in public metadata yet.

eventbridge_create_busCreate a custom event bus

Create a custom event bus

No parameter schema in public metadata yet.

eventbridge_delete_busDelete a custom event bus

Delete a custom event bus

No parameter schema in public metadata yet.

eventbridge_list_rulesList rules on a bus

List rules on a bus

No parameter schema in public metadata yet.

eventbridge_put_ruleCreate or update a rule (event pattern or schedule)

Create or update a rule (event pattern or schedule)

No parameter schema in public metadata yet.

eventbridge_delete_ruleDelete a rule

Delete a rule

No parameter schema in public metadata yet.

eventbridge_describe_ruleDescribe a rule

Describe a rule

No parameter schema in public metadata yet.

eventbridge_enable_ruleEnable a rule

Enable a rule

No parameter schema in public metadata yet.

eventbridge_disable_ruleDisable a rule

Disable a rule

No parameter schema in public metadata yet.

eventbridge_put_targetsAdd or update rule targets

Add or update rule targets

No parameter schema in public metadata yet.

eventbridge_list_targetsList targets for a rule

List targets for a rule

No parameter schema in public metadata yet.

eventbridge_remove_targetsRemove targets from a rule

Remove targets from a rule

No parameter schema in public metadata yet.

eventbridge_put_eventsSend custom events to a bus (max 10)

Send custom events to a bus (max 10)

No parameter schema in public metadata yet.

kinesis_list_streamsList all streams

List all streams

No parameter schema in public metadata yet.

kinesis_create_streamCreate a stream

Create a stream

No parameter schema in public metadata yet.

kinesis_delete_streamDelete a stream

Delete a stream

No parameter schema in public metadata yet.

kinesis_describe_streamDescribe a stream (status, shards)

Describe a stream (status, shards)

No parameter schema in public metadata yet.

kinesis_put_recordPut a single record

Put a single record

No parameter schema in public metadata yet.

kinesis_put_recordsPut multiple records (max 500)

Put multiple records (max 500)

No parameter schema in public metadata yet.

kinesis_get_recordsGet records from a shard

Get records from a shard

No parameter schema in public metadata yet.

dynamodb_list_tablesList all tables

List all tables

No parameter schema in public metadata yet.

dynamodb_create_tableCreate a table (partition key + optional sort key)

Create a table (partition key + optional sort key)

No parameter schema in public metadata yet.

dynamodb_delete_tableDelete a table

Delete a table

No parameter schema in public metadata yet.

dynamodb_describe_tableDescribe a table

Describe a table

No parameter schema in public metadata yet.

dynamodb_put_itemPut (create or replace) an item

Put (create or replace) an item

No parameter schema in public metadata yet.

dynamodb_get_itemGet an item by key

Get an item by key

No parameter schema in public metadata yet.

dynamodb_delete_itemDelete an item by key

Delete an item by key

No parameter schema in public metadata yet.

dynamodb_scanScan all items (with optional filter expression)

Scan all items (with optional filter expression)

No parameter schema in public metadata yet.

dynamodb_queryQuery by key condition

Query by key condition

No parameter schema in public metadata yet.

lambda_list_functionsList all functions

List all functions

No parameter schema in public metadata yet.

lambda_get_functionGet function details

Get function details

No parameter schema in public metadata yet.

lambda_create_functionCreate a function from a base64-encoded ZIP

Create a function from a base64-encoded ZIP

No parameter schema in public metadata yet.

lambda_delete_functionDelete a function

Delete a function

No parameter schema in public metadata yet.

lambda_invokeInvoke a function and return its response + logs

Invoke a function and return its response + logs

No parameter schema in public metadata yet.

secretsmanager_list_secretsList all secrets

List all secrets

No parameter schema in public metadata yet.

secretsmanager_create_secretCreate a new secret

Create a new secret

No parameter schema in public metadata yet.

secretsmanager_get_secretGet the value of a secret

Get the value of a secret

No parameter schema in public metadata yet.

secretsmanager_update_secretUpdate the value of a secret

Update the value of a secret

No parameter schema in public metadata yet.

secretsmanager_describe_secretDescribe secret metadata

Describe secret metadata

No parameter schema in public metadata yet.

secretsmanager_delete_secretDelete a secret (with optional force delete)

Delete a secret (with optional force delete)

No parameter schema in public metadata yet.

secretsmanager_restore_secretRestore a previously deleted secret

Restore a previously deleted secret

No parameter schema in public metadata yet.

ssm_get_parameterGet a parameter by name

Get a parameter by name

No parameter schema in public metadata yet.

ssm_put_parameterCreate or update a parameter

Create or update a parameter

No parameter schema in public metadata yet.

ssm_delete_parameterDelete a parameter

Delete a parameter

No parameter schema in public metadata yet.

ssm_delete_parametersDelete up to 10 parameters in batch

Delete up to 10 parameters in batch

No parameter schema in public metadata yet.

ssm_get_parameters_by_pathGet all parameters under a path prefix

Get all parameters under a path prefix

No parameter schema in public metadata yet.

ssm_describe_parametersList and describe parameters

List and describe parameters

No parameter schema in public metadata yet.

ses_list_identitiesList all verified identities

List all verified identities

No parameter schema in public metadata yet.

ses_verify_email_identityVerify an email address

Verify an email address

No parameter schema in public metadata yet.

ses_get_identity_verification_attributesGet verification status for identities

Get verification status for identities

No parameter schema in public metadata yet.

ses_delete_identityDelete an identity

Delete an identity

No parameter schema in public metadata yet.

ses_send_emailSend an email (plain text and/or HTML)

Send an email (plain text and/or HTML)

No parameter schema in public metadata yet.

Sponsors

Configuration

LOCALSTACK_ENDPOINTdefault: http://localhost:4566

LocalStack endpoint URL

AWS_REGIONdefault: us-east-1

AWS region

AWS_ACCESS_KEY_IDsecret

AWS access key ID

AWS_SECRET_ACCESS_KEYsecret

AWS secret access key

Readme

LocalStack MCP Server

MCP Registry npm

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.

Installation

The server is published to npm and the MCP Registry. No local build needed.

npm install -g @giovane.martins/localstack

Or run directly with npx (no install required):

npx @giovane.martins/localstack

Requirements

  • Node.js 20+
  • Docker (for LocalStack)

Local Development

# 1. Start LocalStack
docker compose up -d

# 2. Install dependencies
pnpm install

# 3. Build
pnpm run build

# 4. Run
pnpm start

Configuration

All configuration is via environment variables:


View the full README on GitHub

Details

Repository
github.com/giovanemartins/localstack-mcp-server
Category
Cloud & Infrastructure
Package
@giovane.martins/localstack
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Cloud & Infrastructure MCP servers

View all
1stayce avatarIcd Mcpstayce/icd-mcp-cloudflareWHO ICD-10/ICD-11 diagnosis codes. Lookup, search, chapters via official WHO API.0stars
2annasmazhar avatarPySpark MCPannasmazhar/pyspark_mcpSQL migration, AWS Glue job generation, and PySpark optimization as an MCP server.0stars
3the-lambda-group avatarOmegaAIthe-lambda-group/query-omega-mcpQuery, browse, and automate OmegaAI workspaces from any MCP client. Streamable HTTP with OAuth 2.0.0stars
4downatthebottomofthemolehole avatarInfracostdownatthebottomofthemolehole/infracost-mcpMCP server for Infracost CLI integration - cloud cost estimates for Infrastructure as Code0stars
5lazymac2x avatarAgent Loop Detectorlazymac2x/agent-loop-detector-apiCloudflare Workers MCP server: agent-loop-detector0stars
6lazymac2x avatarAgent Memorylazymac2x/agent-memory-apiCloudflare Workers MCP server: agent-memory0stars