AWS S3 Tables MCP Server

Databasestdio
Repository

Official AWS Labs MCP server for discovering, querying, and managing Apache Iceberg tables in Amazon S3 Tables. It supports table buckets, namespaces, schemas, read-only SQL, metadata, and CSV or Parquet import. It starts in read-only mode; writes require the explicit --allow-write flag.

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "aws-s3-tables": {
      "command": "uvx",
      "args": [
        "awslabs.s3-tables-mcp-server@latest"
      ],
      "env": {
        "AWS_PROFILE": "<YOUR_AWS_PROFILE>",
        "AWS_REGION": "<YOUR_AWS_REGION>"
      }
    }
  }
}

Tools (5)

list_table_buckets

List S3 Table Buckets available in the selected region.

{
  "type": "object",
  "properties": {
    "region_name": {
      "type": "string",
      "description": "Optional AWS region override"
    }
  }
}

list_namespaces

List namespaces across accessible S3 Table Buckets.

{
  "type": "object",
  "properties": {
    "region_name": {
      "type": "string",
      "description": "Optional AWS region override"
    }
  }
}

list_tables

List tables and their namespace metadata.

{
  "type": "object",
  "properties": {
    "region_name": {
      "type": "string",
      "description": "Optional AWS region override"
    }
  }
}

query_database

Run a read-only SQL query against S3 Tables.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "SQL query to execute"
    },
    "region_name": {
      "type": "string",
      "description": "Optional AWS region override"
    }
  }
}

get_table_metadata_location

Return the metadata location for a selected S3 Table.

{
  "type": "object",
  "required": [
    "table_bucket_arn",
    "namespace",
    "table_name"
  ],
  "properties": {
    "namespace": {
      "type": "string",
      "description": "Table namespace"
    },
    "table_name": {
      "type": "string",
      "description": "Table name"
    },
    "table_bucket_arn": {
      "type": "string",
      "description": "ARN of the table bucket"
    }
  }
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server information

Author
AWS Labs (@awslabs)
Repository
https://github.com/awslabs/mcp/tree/main/src/s3-tables-mcp-server
License
Apache-2.0
Stars
0
Last updated
September 1, 2026