MCP Directory

How to add AWS S3 Tables MCP Server to Cursor

Official AWS Labs MCP server to manage and query S3 Tables (table buckets, namespaces, tables). Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the AWS S3 Tables MCP Server config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of AWS S3 Tables MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.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 Cursor?

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