This server provides tools for interacting with AWS S3 buckets via the Model Context Protocol.
List all S3 buckets in your AWS account using the
list-s3-buckets
toolOptionally specify the AWS region for listing buckets
Integrates with Claude Desktop for managing S3 bucket operations
Provides tools for interacting with AWS S3 buckets, allowing users to list all S3 buckets in their AWS account with optional region specification.
s3-tools MCP Server
An MCP server that provides tools for interacting with AWS S3 buckets. This server enables direct access to S3 bucket operations through the Model Context Protocol.
Features
Tools
The server currently implements the following tools:
list-s3-buckets: Lists all S3 buckets in your AWS account
Optional
region
parameter to specify AWS regionReturns a formatted list of bucket names
Prerequisites
Python 3.13 or higher
AWS credentials configured (see AWS Credentials Setup)
uv package manager
Installation
From PyPI
From Source
Clone the repository
Install using uv:
AWS Credentials Setup
This server requires AWS credentials to access your S3 buckets. You can configure credentials in several ways:
AWS CLI configuration (Recommended)
aws configureThis will create/update credentials in
~/.aws/credentials
Environment Variables
export AWS_ACCESS_KEY_ID="your_access_key" export AWS_SECRET_ACCESS_KEY="your_secret_key" export AWS_DEFAULT_REGION="your_preferred_region" # optionalIAM Role (if running on AWS infrastructure)
For more information about AWS credentials, see the AWS documentation.
Configuration
Claude Desktop
Add the server configuration to your Claude Desktop config file:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Development Configuration
For development/testing, you can run the server directly from source:
Development
Building
Sync dependencies:
Build package:
Publishing
To publish to PyPI:
Note: You'll need PyPI credentials configured via:
Token:
--token
orUV_PUBLISH_TOKEN
Or username/password:
--username
/UV_PUBLISH_USERNAME
and--password
/UV_PUBLISH_PASSWORD
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector for development:
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An MCP server that provides tools for interacting with AWS S3 buckets, enabling direct access to S3 operations through the Model Context Protocol.
Related Resources
Related MCP Servers
- -securityAlicense-qualityMCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.Last updated -34MIT License
- -securityAlicense-qualityMCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.Last updated -63MIT License
- -securityFlicense-qualityA simplified MCP server that provides a streamlined way to interact with AWS CloudWatch resources (log groups, log queries, and alarms) through the MCP protocol.Last updated -4
- AsecurityAlicenseAqualityAn MCP server that enables interaction with Bitbucket repositories through the Model Context Protocol, supporting both Bitbucket Cloud and Server with features for PR lifecycle management and code review.Last updated -198209MIT License