Let AI agents read the PDFs and spreadsheets in your S3 or R2 bucket: outlines, search, SQL.
Connect Runs on your machine
claude mcp add bucketlens -e BUCKETLENS_BUCKET=<BUCKETLENS_BUCKET> -e BUCKETLENS_ACCESS_KEY_ID=<BUCKETLENS_ACCESS_KEY_ID> -e BUCKETLENS_SECRET_ACCESS_KEY=<BUCKETLENS_SECRET_ACCESS_KEY> -e BUCKETLENS_R2_ACCOUNT_ID=<BUCKETLENS_R2_ACCOUNT_ID> -e BUCKETLENS_ENDPOINT=<BUCKETLENS_ENDPOINT> -e BUCKETLENS_REGION=<BUCKETLENS_REGION> -- uvx bucketlens==0.1.0{
"mcpServers": {
"bucketlens": {
"command": "uvx",
"args": [
"bucketlens==0.1.0"
],
"env": {
"BUCKETLENS_BUCKET": "<BUCKETLENS_BUCKET>",
"BUCKETLENS_ACCESS_KEY_ID": "<BUCKETLENS_ACCESS_KEY_ID>",
"BUCKETLENS_SECRET_ACCESS_KEY": "<BUCKETLENS_SECRET_ACCESS_KEY>",
"BUCKETLENS_R2_ACCOUNT_ID": "<BUCKETLENS_R2_ACCOUNT_ID>",
"BUCKETLENS_ENDPOINT": "<BUCKETLENS_ENDPOINT>",
"BUCKETLENS_REGION": "<BUCKETLENS_REGION>"
}
}
}
}{
"mcpServers": {
"bucketlens": {
"command": "uvx",
"args": [
"bucketlens==0.1.0"
],
"env": {
"BUCKETLENS_BUCKET": "<BUCKETLENS_BUCKET>",
"BUCKETLENS_ACCESS_KEY_ID": "<BUCKETLENS_ACCESS_KEY_ID>",
"BUCKETLENS_SECRET_ACCESS_KEY": "<BUCKETLENS_SECRET_ACCESS_KEY>",
"BUCKETLENS_R2_ACCOUNT_ID": "<BUCKETLENS_R2_ACCOUNT_ID>",
"BUCKETLENS_ENDPOINT": "<BUCKETLENS_ENDPOINT>",
"BUCKETLENS_REGION": "<BUCKETLENS_REGION>"
}
}
}
}{
"servers": {
"bucketlens": {
"type": "stdio",
"command": "uvx",
"args": [
"bucketlens==0.1.0"
],
"env": {
"BUCKETLENS_BUCKET": "<BUCKETLENS_BUCKET>",
"BUCKETLENS_ACCESS_KEY_ID": "<BUCKETLENS_ACCESS_KEY_ID>",
"BUCKETLENS_SECRET_ACCESS_KEY": "<BUCKETLENS_SECRET_ACCESS_KEY>",
"BUCKETLENS_R2_ACCOUNT_ID": "<BUCKETLENS_R2_ACCOUNT_ID>",
"BUCKETLENS_ENDPOINT": "<BUCKETLENS_ENDPOINT>",
"BUCKETLENS_REGION": "<BUCKETLENS_REGION>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
BUCKETLENS_BUCKETRequired | Bucket to read |
BUCKETLENS_ACCESS_KEY_IDRequired, secret | Access key that can read the bucket and write under .bucketlens/ |
BUCKETLENS_SECRET_ACCESS_KEYRequired, secret | Secret for that access key |
BUCKETLENS_R2_ACCOUNT_IDOptional | Cloudflare account ID (for R2; sets the endpoint for you) |
BUCKETLENS_ENDPOINTOptional | S3 endpoint URL (for AWS S3, MinIO or other S3-compatible storage) |
BUCKETLENS_REGIONOptional | Region (auto for R2) |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 15 Nov 2026 |
| Last updated | 15 Nov 2026 |
| Registry name | io.github.Pritom14/bucketlens |
More search and web servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.