MCP Directory

How to add AWS S3 Tables MCP Server to Claude Desktop

Official AWS Labs MCP server to manage and query S3 Tables (table buckets, namespaces, tables). Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 9.2k★ · stdio · apikey · official

Claude Desktop config for AWS S3 Tables MCP Server

uvx awslabs.s3-tables-mcp-server@latest
{
  "mcpServers": {
    "aws-s3-tables-mcp-server": {
      "command": "uvx",
      "args": [
        "awslabs.s3-tables-mcp-server@latest"
      ],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_PROFILE": "<your-aws-profile>"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the AWS S3 Tables MCP Server config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm AWS S3 Tables MCP Server's tools appear under the 🔌 tools menu.

Before you start

  • Python 3.10+ and the uv package manager (the server runs via uvx)
  • An AWS account with S3 Tables enabled in your region
  • AWS credentials configured locally (via `aws configure`, an AWS_PROFILE, or environment variables) with IAM permissions for S3 Tables actions (s3tables:*) and, for SQL queries, the relevant analytics/Lake Formation access
  • Docker is supported as an alternative to uvx for containerized deployment

What AWS S3 Tables MCP Server can do in Claude Desktop

list_table_buckets

List the S3 table buckets in your account/region.

create_table_bucket

Create a new S3 table bucket (write).

list_namespaces

List namespaces within a table bucket.

create_namespace

Create a namespace inside a table bucket (write).

list_tables

List tables within a namespace.

create_table

Create a new Iceberg table (write).

rename_table

Rename an existing table (write).

get_table_metadata

Retrieve a table's metadata and schema.

Security

It uses your local AWS credentials/profile, so it inherits whatever IAM permissions that profile holds; use a least-privilege profile. Write actions require the explicit --allow-write flag, which can create or modify AWS resources and incur cost.

AWS S3 Tables MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the AWS S3 Tables MCP Server config there under the "mcpServers" key and restart the client.

Is AWS S3 Tables MCP Server safe to use with Claude Desktop?

It uses your local AWS credentials/profile, so it inherits whatever IAM permissions that profile holds; use a least-privilege profile. Write actions require the explicit --allow-write flag, which can create or modify AWS resources and incur cost.

How does authentication work?

It uses your standard AWS credential chain — an AWS_PROFILE, environment variables, or `aws configure` output. There is no separate API key; permissions come from the IAM identity those credentials resolve to.

Is it safe to run against production data?

Yes by default. The server starts in read-only mode and only exposes write tools (create bucket/namespace/table, CSV import, data append) when you explicitly pass `--allow-write`.

What does the SQL query tool support?

`run_sql_query` executes read-only queries over your S3 Tables (Iceberg) data. It is intended for analytics and exploration, not for mutating table contents.

View repo Full AWS S3 Tables MCP Server page