S3 Mcp
About
Manage AWS S3 buckets and objects, including policies, tagging, and configurations.
Details
- Author
- ashgw
- Downloads
- 420
- Categories
- File Management, Other, Infrastructure
Jump to
- List, create, and delete S3 buckets
- List, get, put, delete, and copy objects
- Generate presigned URLs for objects
- Manage bucket policies (set, get, delete)
- Configure lifecycle rules and CORS
- Set and retrieve object tags
- Upload local files and download to local path
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
S3 McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
S3 Mcp can be run via Docker with AWS credentials passed as environment variables. It can be configured in Cursor by adding a Docker-based MCP server entry to the Cursor MCP configuration. Manual Docker execution is also supported, and the server can be built from the repository.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"s3 mcp": {
"s3-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AWS_SECRET_ACCESS_KEY=your_access_key",
"-e",
"AWS_ACCESS_KEY_ID=your_access_key",
"-e",
"AWS_REGION=your_region",
"ashgw/s3-mcp:latest"
]
}
}
}
}McpServers
{
"s3-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AWS_SECRET_ACCESS_KEY=your_access_key",
"-e",
"AWS_ACCESS_KEY_ID=your_access_key",
"-e",
"AWS_REGION=your_region",
"ashgw/s3-mcp:latest"
]
}
}Overview
This server enables you to:
- Manage S3 buckets and objects
- Handle lifecycle configurations
- Set and retrieve object tags
- Manage bucket policies
- Configure CORS settings
Installation
There are multiple ways to use this server depending on your setup.
Cursor (recommended)
Add this to your Cursor MCP configuration:
{
"mcpServers": {
"s3-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AWS_SECRET_ACCESS_KEY=your_access_key",
"-e",
"AWS_ACCESS_KEY_ID=your_access_key",
"-e",
"AWS_REGION=your_region",
"ashgw/s3-mcp:latest"
]
}
}
}
> If you prefer pinning to a specific Docker image build (e.g., 20250413-165732), use that tag instead of latest. Browse available versions on Docker Hub.
Cursor will route that request through the MCP server automatically.
Make sure it's green and all the tools are available.
---
Docker (manual)
You can run the S3 MCP server manually via Docker:
docker run --rm -it \
-e AWS_ACCESS_KEY_ID=your_access_key \
-e AWS_SECRET_ACCESS_KEY=your_secret_key \
-e AWS_REGION=your_region \
ashgw/s3-mcp
This uses the pre-built image published at ashgw/s3-mcp.
---
Repo
Clone the repository and cd into it, then build with:
docker build -t s3-mcp .
Then run with:
docker run --rm -e AWS_ACCESS_KEY_ID=your_access_key -e AWS_SECRET_ACCESS_KEY=your_secret_key -e AWS_REGION=your_region s3-mcp
Environment Variables
Set the following environment variables for AWS credentials:
export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=your_region
Features
- List Buckets: Retrieve a list of all S3 buckets.
- Create Bucket: Create a new S3 bucket with optional configurations.
- List Objects: List all objects in a specified bucket.
- Get Object: Retrieve the content of a specified object.
- Put Object: Upload an object to a specified bucket.
- Delete Object: Remove an object from a specified bucket.
- Generate Presigned URL: Create a presigned URL for accessing or uploading an object.
- Set Bucket Policy: Update or set a policy for a specified bucket.
- Get Bucket Policy: Retrieve the current policy for a specified bucket.
- Delete Bucket Policy: Remove the current policy for a specified bucket.
- Lifecycle Configuration: Manage lifecycle rules for S3 buckets.
- Object Tagging: Set and retrieve tags for S3 objects.
- CORS Configuration: Get and set CORS rules for a bucket.
- Copy Object: Copy an object from one location to another within S3.
- Download File to Local: Download a file from a specified S3 bucket to a local path.
- Upload Local File: Upload a local file to a specified S3 bucket.
Few Usage Examples
List Buckets
response = await tool("list_buckets")
print(response)
Create a Bucket
response = await tool("create_bucket", {
"bucket_name": "my-new-bucket",
"region": "us-west-1",
"config": {
"blockPublicAccess": {
"BlockPublicAcls": True,
"IgnorePublicAcls": True,
"BlockPublicPolicy": True,
"RestrictPublicBuckets": True
},
"versioning": True,
"encryption": "AES256"
}
})
print(response)
Upload a File
response = await tool("upload_local_file", {
"bucket_name": "my-new-bucket",
"local_path": "/path/to/local/file.txt",
"key": "file.txt"
})
print(response)
Get Object Tags
response = await tool("get_object_tagging", {
"bucket_name": "my-new-bucket",
"key": "file.txt"
})
print(response)
License
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
