Log inSubmit server
MCP Server S3 logo

MCP Server S3

by ofershap

Manage S3 buckets and text objects through MCP, including uploads, downloads, deletion, and presigned URLs.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server S3

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ofershap-mcp-server-s3": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-s3"
      ],
      "env": {
        "AWS_REGION": "YOUR_VALUE_HERE",
        "AWS_ACCESS_KEY_ID": "YOUR_VALUE_HERE",
        "AWS_SECRET_ACCESS_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 7 tools correctly (1mo ago).

Overview

The ofershap/mcp-server-s3 MCP server exposes AWS S3 bucket and object operations as MCP tools. It uses the standard AWS credential chain, reading environment variables, shared credentials, or IAM roles on the host. Use it when an MCP client needs to browse buckets, read or write text objects, remove objects, check buckets, or create temporary object links. Object content handled by the tools is text.

Use cases

  • List buckets available to an AWS identity
  • Browse objects under an S3 prefix
  • Read a text configuration object
  • Upload text content to an S3 key
  • Generate a temporary object URL

Key features

  • List S3 buckets
  • Browse objects with prefix and count filters
  • Read and upload text objects
  • Delete S3 objects
  • Generate presigned URLs
  • Check bucket existence and basic information

Tools7

What MCP Server S3 lets your agent do. Expand a tool for its parameters.

Verified live~589 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

17/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · mcp-server-s3 (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads458Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed7Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server S3 works

What ofershap/mcp-server-s3 MCP server does

The ofershap/mcp-server-s3 MCP server connects an MCP client to AWS S3. It provides operations for discovering buckets, browsing keys, reading text content, writing text content, deleting objects, checking bucket availability, and creating presigned URLs for temporary access.

This is intended for tasks where an agent needs direct S3 operations without requiring the user to construct AWS CLI commands. Typical requests include listing available buckets, finding objects below a prefix, downloading a configuration file as text, uploading notes, or generating a link that expires after a specified period.

How it works

The ofershap/mcp-server-s3 MCP server runs locally through the npm package and communicates with the client over MCP. AWS authentication follows the default credential chain: environment variables are checked first, then the shared credentials file at ~/.aws/credentials, followed by IAM role credentials when the process runs in a supported AWS environment such as EC2, ECS, or Lambda.

The AWS identity used by the host must have permissions appropriate to the requested operations. The documented permissions include s3:ListBuckets, s3:ListBucket, s3:GetObject, s3:PutObject, s3:DeleteObject, and s3:HeadBucket. Region selection comes from AWS_REGION, which defaults to us-east-1 when not set.

Setup and configuration

Install and start the server with npx mcp-server-s3. MCP client configuration passes the command and AWS settings in the server environment. The README provides configurations for Cursor, Claude Desktop, and VS Code. Cursor users can also load the repository as a local Agent Plugin from ~/.cursor/plugins/local/mcp-server-s3.

Set AWS_REGION and provide AWS_ACCESS_KEY_ID plus AWS_SECRET_ACCESS_KEY when using environment-based credentials. Alternatively, make the shared AWS credentials file or an instance/container IAM role available to the process. The project does not provide OAuth or AWS SSO wiring through its Agent Plugins package.

Tools and capabilities

The available tools are:

  • list_buckets: returns all buckets visible in the AWS account.
  • list_objects: lists objects in a selected bucket, with optional prefix filtering and a count limit.
  • get_object: retrieves an S3 object and reads its contents as text.
  • delete_object: removes an object from a bucket.
  • presigned_url: creates a temporary URL for an object.
  • bucket_info: checks whether a bucket exists and returns basic information.

Limitations and notes

The ofershap/mcp-server-s3 MCP server documents text upload and text reading rather than general binary file handling. Access is governed by the AWS permissions of the configured identity, so a tool call can fail if the identity lacks the corresponding S3 action. Credentials are expected to remain in the client host environment or its AWS credential sources; the README specifically notes that one-click installation is not offered because secrets cannot be embedded in a portable install link. The project is MIT licensed and includes development commands for type checking, building, testing, formatting, and linting.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server S3

Run `npx mcp-server-s3`, or configure an MCP client to launch that command.

Yes. The README provides Claude Desktop configuration using `npx mcp-server-s3` and AWS environment variables.

It uses the standard AWS credential chain: environment variables, `~/.aws/credentials`, or IAM roles on supported AWS hosts.

It can upload text content and download or read S3 object content as text.

The documented permissions are `s3:ListBuckets`, `s3:ListBucket`, `s3:GetObject`, `s3:PutObject`, `s3:DeleteObject`, and `s3:HeadBucket`.

Related MCP servers

All in Cloud Platforms All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server S3 AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ofershap-mcp-server-s3?style=directory)](https://allmcps.com/mcp/ofershap-mcp-server-s3)
HTML Embed
<a href="https://allmcps.com/mcp/ofershap-mcp-server-s3"><img src="https://allmcps.com/api/badge/ofershap-mcp-server-s3?style=directory" alt="MCP Server S3 on AllMCPs" /></a>