article

README

AWS MCP Server

A Model Context Protocol server implementation for AWS operations that currently supports S3 and DynamoDB services. All operations are automatically logged and can be accessed through the audit://aws-operations resource endpoint.

See a demo video here.

Listed as a Community Server within the MCP servers repository.

Running locally with the Claude desktop app

Installing via Smithery

To install AWS MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-server-aws --client claude

Manual Installation

Clone this repository.
Set up your AWS credentials via one of the two methods below. Note that this server requires an IAM user with RW permissions for your AWS account for S3 and DynamoDB.

Environment variables: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION (defaults to us-east-1)
Default AWS credential chain (set up via AWS CLI with aws configure)

Add the following to your claude_desktop_config.json file:

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "mcp-server-aws": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/repo/mcp-server-aws",
      "run",
      "mcp-server-aws"
    ]
  }
}

Install and open the Claude desktop app.
Try asking Claude to do a read/write operation of some sort to confirm the setup (e.g. create an S3 bucket and give it a random name). If there are issues, use the Debugging tools provided in the MCP documentation here.

Available Tools

S3 Operations

s3_bucket_create: Create a new S3 bucket
s3_bucket_list: List all S3 buckets
s3_bucket_delete: Delete an S3 bucket
s3_object_upload: Upload an object to S3
s3_object_delete: Delete an object from S3
s3_object_list: List objects in an S3 bucket
s3_object_read: Read an object's content from S3

DynamoDB Operations

Table Operations

dynamodb_table_create: Create a new DynamoDB table
dynamodb_table_describe: Get details about a DynamoDB table
dynamodb_table_delete: Delete a DynamoDB table
dynamodb_table_update: Update a DynamoDB table

Item Operations

dynamodb_item_put: Put an item into a DynamoDB table
dynamodb_item_get: Get an item from a DynamoDB table
dynamodb_item_update: Update an item in a DynamoDB table
dynamodb_item_delete: Delete an item from a DynamoDB table
dynamodb_item_query: Query items in a DynamoDB table
dynamodb_item_scan: Scan items in a DynamoDB table

Batch Operations

dynamodb_batch_get: Batch get multiple items from DynamoDB tables
dynamodb_item_batch_write: Batch write operations (put/delete) for DynamoDB items
dynamodb_batch_execute: Execute multiple PartiQL statements in a batch

TTL Operations

dynamodb_describe_ttl: Get the TTL settings for a table
dynamodb_update_ttl: Update the TTL settings for a table

mcp-server-aws