Skip to main content
Glama
Sign In
MinIO MCP Server

MinIO MCP Server

by Raphaelren
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

MinIO MCP Server

MCP (Model Context Protocol) server for MinIO object storage operations. This server provides tools for interacting with MinIO/S3-compatible storage through Claude and other MCP clients.

Features

Bucket Operations

  • minio_list_buckets - List all buckets

  • minio_make_bucket - Create a new bucket

  • minio_remove_bucket - Remove an empty bucket

  • minio_bucket_exists - Check if a bucket exists

Object Operations

  • minio_list_objects - List objects in a bucket

  • minio_get_object - Get object content

  • minio_put_object - Upload content as an object

  • minio_upload_file - Upload a local file

  • minio_download_file - Download object to local file

  • minio_remove_object - Remove an object

  • minio_stat_object - Get object metadata

  • minio_presigned_url - Generate presigned download URL

  • minio_copy_object - Copy object to another location

Related MCP server: S3 MCP Server

Installation

Using pip

pip install minio-mcp

Using uv (recommended)

uv pip install minio-mcp

From source

git clone <repository-url>
cd minio-mcp
pip install -e .

Configuration

Set the following environment variables:

export MINIO_ENDPOINT="localhost:9000"
export MINIO_ACCESS_KEY="your-access-key"
export MINIO_SECRET_KEY="your-secret-key"
export MINIO_SECURE="false"  # Set to "true" for HTTPS

Or create a .env file:

MINIO_ENDPOINT=localhost:9000
MINIO_ACCESS_KEY=your-access-key
MINIO_SECRET_KEY=your-secret-key
MINIO_SECURE=false

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/AppData/Roaming/Claude/claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "minio": {
      "command": "uv",
      "args": ["--directory", "D:\\Documents\\minio-mcp", "run", "minio-mcp"],
      "env": {
        "MINIO_ENDPOINT": "localhost:9000",
        "MINIO_ACCESS_KEY": "your-access-key",
        "MINIO_SECRET_KEY": "your-secret-key",
        "MINIO_SECURE": "false"
      }
    }
  }
}

Or using Python directly:

{
  "mcpServers": {
    "minio": {
      "command": "python",
      "args": ["-m", "minio_mcp.server"],
      "env": {
        "MINIO_ENDPOINT": "localhost:9000",
        "MINIO_ACCESS_KEY": "your-access-key",
        "MINIO_SECRET_KEY": "your-secret-key",
        "MINIO_SECURE": "false"
      }
    }
  }
}

Tool Reference

Bucket Operations

minio_list_buckets

List all buckets in MinIO storage.

{}

minio_make_bucket

Create a new bucket.

{
  "bucket_name": "my-new-bucket"
}

minio_remove_bucket

Remove an empty bucket.

{
  "bucket_name": "my-bucket"
}

minio_bucket_exists

Check if a bucket exists.

{
  "bucket_name": "my-bucket"
}

Object Operations

minio_list_objects

List objects in a bucket.

{
  "bucket_name": "my-bucket",
  "prefix": "folder/",
  "recursive": true
}

minio_get_object

Get object content.

{
  "bucket_name": "my-bucket",
  "object_name": "path/to/file.txt"
}

minio_put_object

Upload content as an object.

{
  "bucket_name": "my-bucket",
  "object_name": "new-file.txt",
  "content": "Hello, MinIO!",
  "content_type": "text/plain"
}

minio_upload_file

Upload a local file.

{
  "bucket_name": "my-bucket",
  "object_name": "uploaded-file.txt",
  "file_path": "/path/to/local/file.txt"
}

minio_download_file

Download object to local file.

{
  "bucket_name": "my-bucket",
  "object_name": "file.txt",
  "file_path": "/path/to/save/file.txt"
}

minio_remove_object

Remove an object.

{
  "bucket_name": "my-bucket",
  "object_name": "file-to-delete.txt"
}

minio_stat_object

Get object metadata.

{
  "bucket_name": "my-bucket",
  "object_name": "file.txt"
}

minio_presigned_url

Generate a presigned URL for downloading.

{
  "bucket_name": "my-bucket",
  "object_name": "file.txt",
  "expires": 3600
}

minio_copy_object

Copy an object.

{
  "source_bucket": "source-bucket",
  "source_object": "file.txt",
  "dest_bucket": "dest-bucket",
  "dest_object": "copied-file.txt"
}

Development

Setup Development Environment

# Clone the repository
git clone <repository-url>
cd minio-mcp

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate  # Windows

# Install with dev dependencies
pip install -e ".[dev]"

Running Tests

pytest

Quick Start with MinIO

If you don't have MinIO running, you can start it with Docker:

docker run -d \
  --name minio \
  -p 9000:9000 \
  -p 9001:9001 \
  -e MINIO_ROOT_USER=minioadmin \
  -e MINIO_ROOT_PASSWORD=minioadmin \
  minio/minio server /data --console-address ":9001"

Then configure the MCP server with:

  • MINIO_ENDPOINT=localhost:9000

  • MINIO_ACCESS_KEY=minioadmin

  • MINIO_SECRET_KEY=minioadmin

  • MINIO_SECURE=false

The MinIO Console will be available at http://localhost:9001

License

MIT License

Available Tools

13 tools
minio_bucket_existsB

Check if a bucket exists in MinIO

Inputs: bucket_name (required).

minio_copy_objectC

Copy an object to another location in MinIO

Inputs: source_bucket (required), source_object (required), dest_bucket (required), dest_object (required).

minio_download_fileB

Download an object from MinIO to a local file

Inputs: bucket_name (required), object_name (required), file_path (required).

minio_get_objectC

Get object content from MinIO bucket

Inputs: bucket_name (required), object_name (required).

minio_list_bucketsB

List all buckets in MinIO storage

Inputs: no named parameters.

minio_list_objectsC

List objects in a MinIO bucket

Inputs: bucket_name (required), prefix, recursive.

minio_make_bucketC

Create a new bucket in MinIO

Inputs: bucket_name (required).

minio_presigned_urlC

Generate a presigned URL for object download

Inputs: bucket_name (required), object_name (required), expires.

minio_put_objectC

Upload content as an object to MinIO bucket

Inputs: bucket_name (required), object_name (required), content (required), content_type.

minio_remove_bucketB

Remove an empty bucket from MinIO

Inputs: bucket_name (required).

minio_remove_objectC

Remove an object from a MinIO bucket

Inputs: bucket_name (required), object_name (required).

minio_stat_objectA

Get object metadata without downloading content

Inputs: bucket_name (required), object_name (required).

minio_upload_fileC

Upload a local file to MinIO bucket

Inputs: bucket_name (required), object_name (required), file_path (required), content_type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 13 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity. Each targets a specific action on a specific resource (buckets or objects), such as minio_bucket_exists for checking existence versus minio_make_bucket for creation, and minio_get_object for content retrieval versus minio_stat_object for metadata. The descriptions reinforce these distinctions, making misselection unlikely.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with the prefix 'minio_' and snake_case throughout. The verbs are clear and descriptive (e.g., list, get, make, remove), and the nouns specify the target (e.g., buckets, objects, bucket, object). This predictability aids agent understanding and tool selection.

    Tool Count5/5

    With 13 tools, the count is well-scoped for a MinIO storage server, covering essential operations for bucket and object management. Each tool earns its place by addressing a specific need, such as existence checks, CRUD operations, listing, and utilities like presigned URLs, without being overly sparse or bloated.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage for the MinIO domain, including bucket operations (create, list, check, remove) and object operations (upload, download, copy, get, remove, stat, presigned URLs). There are no obvious gaps, enabling agents to handle full workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Akave MCP Server

      akave-ai
      F
      license
      B
      quality
      D
      maintenance
      Enables AI models to interact with Akave's S3-compatible storage by providing tools for managing storage buckets and objects through standardized Model Context Protocol (MCP).
      13
      45 npm
      3
      -

    • S3 MCP Server

      rccyx
      A
      license
      Not graded
      quality
      F
      maintenance
      Enables interaction with AWS S3 through MCP, supporting bucket and object management, lifecycle configurations, tagging, policies, CORS settings, presigned URLs, and file uploads/downloads.
      3
      MIT

    • bucket-helper-mcp

      warith-harchaoui
      A
      license
      Not graded
      quality
      B
      maintenance
      Provides MCP tools for AWS S3 and S3-compatible storage, enabling file upload, download, listing, deletion, and temporary remote file staging via natural language.
      BSD 3-Clause

    • minio-mcp-server

      saeedshoh
      F
      license
      Not graded
      quality
      D
      maintenance
      Enables LLM agents to interact with MinIO/S3 object storage, supporting bucket and object operations like listing, reading, writing, and generating presigned URLs.
      1
      -