Backblaze B2 MCP Server


A Model Context Protocol (MCP) server that provides seamless integration with Backblaze B2 cloud storage. Built as a wrapper around the backblaze-b2 npm package, this server enables MCP clients like Claude Desktop, VS Code, and Cursor to interact with your B2 buckets and files.

Features

- Bucket Management - Create, delete, list, and update buckets
- File Operations - Upload, list, hide, and delete files
- Large File Support - Multipart uploads for files >100MB
- Key Management - Manage application keys and permissions
- Simple Setup - Just configure your B2 credentials in MCP config

Configuration

$3

1. Sign up at Backblaze B2
2. Go to App Keys in your account
3. Create a new application key
4. Copy the keyID and applicationKey

$3

Add this configuration to your MCP client:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

``json
{
"mcpServers": {
"backblaze-b2": {
"command": "npx",
"args": ["backblaze-mcp"],
"env": {
"B2_APPLICATION_KEY_ID": "your_key_id_here",
"B2_APPLICATION_KEY": "your_application_key_here"
}
}
}
}
`

VS Code/Cursor (.vscode/mcp.json):

`json
{
"servers": {
"backblaze-b2": {
"command": "npx",
"args": ["backblaze-mcp"],
"env": {
"B2_APPLICATION_KEY_ID": "your_key_id_here",
"B2_APPLICATION_KEY": "your_application_key_here"
}
}
}
}
`

Available Tools

$3

- createBucket - Create a new bucket
- deleteBucket - Delete a bucket
- listBuckets - List all buckets
- getBucket - Get bucket info
- updateBucket - Change bucket type (public/private)

$3

- getUploadUrl - Get upload URL
- uploadFile - Upload a file (base64-encoded)
- listFileNames - List files in a bucket
- listFileVersions - List all file versions
- hideFile - Hide a file from listings
- getFileInfo - Get file metadata
- deleteFileVersion - Delete a file version
- getDownloadAuthorization - Get download auth token

$3

For files >100MB:

- startLargeFile - Start large file upload
- getUploadPartUrl - Get part upload URL
- uploadPart - Upload a file part
- listParts - List uploaded parts
- finishLargeFile - Complete the upload
- cancelLargeFile - Cancel the upload

$3

- createKey - Create application keys
- deleteKey - Delete a key
- listKeys - List all keys

Usage Examples

$3

`
1. Call getUploadUrl with your bucketId
2. Encode your file to base64
3. Call uploadFile with the URL, token, filename, and base64 data
`

$3

`
1. Call startLargeFile to get a fileId
2. Split file into parts and upload each with uploadPart
3. Call finishLargeFile with SHA1 hashes of all parts
`

Development

$3

`bash
git clone https://github.com/braveram/backblaze-mcp.git
cd backblaze-mcp
npm install
npm run build
`

Binary Data

File uploads use base64 encoding:

- Encode your file to base64 before calling uploadFile or uploadPart
- The server handles the conversion to binary for B2

Troubleshooting

Server won't start
- Check that B2_APPLICATION_KEY_ID and B2_APPLICATION_KEY` are set in your MCP config
- Verify credentials are valid in the B2 console

Upload fails
- Ensure data is properly base64-encoded
- Check bucket permissions
- Use large file operations for files >100MB

Built With

- backblaze-b2 - Official Backblaze B2 client
- @modelcontextprotocol/sdk - MCP SDK

License

MIT