What is AWS

AWS MCP Server is an implementation of the Model Context Protocol designed for AWS operations, enabling integration with S3 and DynamoDB services. It provides structured access to these services while logging all operations for auditing purposes.

Use cases

Key use cases include managing S3 buckets and objects, as well as handling DynamoDB tables and items efficiently. Users can perform operations such as creating, listing, and deleting resources, which facilitates cloud resource management and application data management.

How to use

To use the AWS MCP Server, install it via Smithery for the Claude desktop app or set it up manually by cloning the repository and configuring AWS credentials. Users need to edit the claude_desktop_config.json file to include the server command and then can interact with AWS services through Claude by issuing read/write requests.

Key features

The server supports a wide range of operations for both S3 and DynamoDB, including creating and deleting resources, uploading and retrieving objects, as well as batch operations and TTL management for DynamoDB tables. Additionally, all operations are automatically logged for audit purposes.

Where to use

This server is ideal for environments where AWS services are utilized, such as applications requiring data storage and retrieval, quick scalability, and the need for dynamic cloud resource management, particularly for developers and data engineers working with cloud infrastructure.

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

1. Clone this repository.
2. 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)

3. 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"
    ]
  }
}

4. Install and open the Claude desktop app.
5. 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