mcp-server-s3
This server provides tools to manage AWS S3 buckets and objects directly from your AI assistant.
List buckets (
list_buckets): List all S3 buckets in your AWS account.List objects (
list_objects): List objects in a bucket, with optional prefix filtering and a configurable result limit (up to 1,000).Get object (
get_object): Download and read an object's contents as text.Put object (
put_object): Upload text content to an object, optionally specifying a content type.Delete object (
delete_object): Delete an object from a bucket.Generate presigned URL (
presigned_url): Generate a temporary presigned URL for an object, with configurable expiry (from 60 seconds up to 7 days; default 1 hour).Bucket info (
bucket_info): Check if a bucket exists and get basic information.
mcp-server-s3
Manage AWS S3 buckets and objects from your AI assistant. Browse files, upload and download content, and generate presigned URLs.
npx mcp-server-s3Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Uses your existing AWS credentials (
~/.aws/credentialsor environment variables).

Demo built with remotion-readme-kit
Why
S3 is the most widely used cloud storage service, but managing it from the command line means remembering aws s3 ls, aws s3 cp, presigned URL syntax, and various flags. Google has an official MCP for GCS, Cloudflare has one for R2, but AWS S3 doesn't have a polished standalone MCP server on npm. This one lets you ask your assistant to list buckets, download a config file, upload content, or generate a temporary sharing link. It uses the standard AWS credential chain, so if your CLI already works, this works too.
Related MCP server: s3-mcp
Tools
Tool | What it does |
| List all S3 buckets in your AWS account. |
| List objects in a bucket, with optional prefix filter. |
| Download and read an object's content as text. |
| Upload text content to an S3 object. |
| Delete an object from a bucket. |
| Generate a temporary presigned URL for an object. |
| Check if a bucket exists and get basic info. |
Quick Start
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"s3": {
"command": "npx",
"args": ["mcp-server-s3"],
"env": {
"AWS_REGION": "us-east-1",
"AWS_ACCESS_KEY_ID": "your-access-key",
"AWS_SECRET_ACCESS_KEY": "your-secret-key"
}
}
}
}Claude Desktop
Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"s3": {
"command": "npx",
"args": ["mcp-server-s3"],
"env": {
"AWS_REGION": "us-east-1",
"AWS_ACCESS_KEY_ID": "your-access-key",
"AWS_SECRET_ACCESS_KEY": "your-secret-key"
}
}
}
}VS Code
Configure the MCP server to run npx mcp-server-s3 with AWS_REGION, AWS_ACCESS_KEY_ID, and AWS_SECRET_ACCESS_KEY in the environment.
Authentication
The server uses the standard AWS credential chain:
Environment variables:
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY,AWS_REGIONShared credentials file:
~/.aws/credentialsIAM roles: when running on EC2, ECS, Lambda, or similar
Set AWS_REGION (defaults to us-east-1) and make sure your credentials have the necessary S3 permissions: s3:ListBuckets, s3:ListBucket, s3:GetObject, s3:PutObject, s3:DeleteObject, s3:HeadBucket.
Agent Plugins
This repo is an Agent Plugins 1.0.0 package: plugin.json, portable mcp.json, and skills/ ship together with the MCP server.
For Cursor, clone the repo and copy or symlink it to ~/.cursor/plugins/local/mcp-server-s3, then reload the window. Skills and MCP show up under Customize > Plugins.
Agent Plugins v1 does not ship OAuth or AWS SSO wiring. Set AWS_REGION and credentials via env or ~/.aws/credentials in the MCP client host. One-click install is not offered because secrets stay in env.
FAQ
What is mcp-server-s3?
An MCP server for S3: list buckets and objects, read/upload text objects, delete keys, presigned URLs, and bucket checks.
How does authentication work?
Standard AWS credential chain: env vars, shared credentials file, or IAM role on the machine running the MCP server.
Which env vars should I set in MCP config?
At minimum AWS_REGION. Often AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY unless you rely on ~/.aws/credentials or a role.
Can I install it as an Agent Plugin in Cursor?
Yes, via ~/.cursor/plugins/local/mcp-server-s3. Ensure the Cursor process can read the same AWS credentials as your CLI.
Why no one-click Cursor button?
AWS keys cannot be embedded in a portable install link. Use the JSON under Quick Start.
Example prompts
"List all my S3 buckets"
"Show me the files in my-bucket/uploads/"
"Download the config.json from my-bucket"
"Upload this content to my-bucket/notes.txt"
"Generate a presigned URL for this file that expires in 1 hour"
Development
npm install
npm run typecheck
npm run build
npm test
npm run format
npm run lintSee also
More MCP servers and developer tools on my portfolio.
Author
README built with README Builder
License
MIT © 2026 Ofer Shapira
Available Tools
7 toolsbucket_infoC
Check if a bucket exists and get basic info.
Inputs: bucket (required).
delete_objectC
Delete an object from an S3 bucket.
Inputs: bucket (required), key (required).
get_objectA
Download and read the contents of an S3 object as text.
Inputs: bucket (required), key (required).
list_bucketsB
List all S3 buckets in your AWS account.
Inputs: no named parameters.
list_objectsB
List objects in an S3 bucket. Optionally filter by prefix and limit count.
Inputs: bucket (required), prefix, maxKeys.
presigned_urlC
Generate a presigned URL for temporary access to an S3 object.
Inputs: bucket (required), key (required), expiresIn.
put_objectC
Upload text content to an S3 object.
Inputs: bucket (required), key (required), content (required), contentType.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose targeting specific S3 operations: bucket existence checks, deletion, downloading, listing buckets, listing objects, generating URLs, and uploading. There is no overlap or ambiguity between tools like list_buckets and list_objects, which serve different scopes.
All tools follow a consistent verb_noun pattern with snake_case (e.g., list_buckets, get_object, put_object). The naming is predictable and readable throughout, making it easy for agents to understand the action and target.
With 7 tools, this server is well-scoped for S3 operations, covering essential CRUD and management tasks without being overwhelming. Each tool earns its place, providing a balanced set for common workflows like listing, reading, writing, and deleting objects and buckets.
The toolset covers core S3 operations including create (put_object), read (get_object, list_*), update (implied via put_object overwrite), and delete, plus utilities like presigned_url and bucket_info. A minor gap is the lack of explicit bucket creation/deletion tools, but agents can work around this using AWS CLI or other methods.
Maintenance
Related MCP Connectors
An MCP server for the STRG.com s3-compatible object storage network for all management operations. Full documentation access, ask questions, create buckets, configure scoped access keys, CORS rules, lifecycle policies and perform any S3 operation.
Browse, upload, download, and share files in your S3-compatible buckets with delegated roles.
Browse, upload, download, copy, move and share files in your own S3-compatible buckets.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- FlicenseBqualityDmaintenanceAn MCP server that provides tools for interacting with AWS S3 buckets, enabling direct access to S3 operations through the Model Context Protocol.1-
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server for AWS S3 integration using FastMCP and boto3. This server provides access to S3 functionality through MCP-compatible tools.101MIT
- AlicenseAqualityDmaintenanceMCP server for uploading, listing, and retrieving files on S3-compatible storage (AWS S3, DigitalOcean Spaces) with public/private access and temporary URLs.4MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for AWS S3 and compatible object stores, enabling LLM clients to browse buckets and fetch objects.MIT No Attribution