PlugWiki
dynamodb-mcp-server logo

AWS DynamoDB MCP Server: Setup for Claude, Cursor and Other Apps

Official · by Amazon Web ServicesLocal
GetPyPIawslabs.dynamodb-mcp-serverawslabs/mcp/tree/HEAD/src/dynamodb-mcp-server

Helps your AI assistant design DynamoDB tables, test the design locally and generate the code and CDK for it.

This AWS Labs server is a design helper, not a way to read or edit the data in your DynamoDB tables. It takes you from access patterns to a data model, a cost estimate, a local test and generated Python code and CDK.

It runs on your computer and writes its output as files in your project folder. Checking a design needs Docker, Podman, Finch, nerdctl or Java 17 or newer.

Good for

  • Developers designing a new DynamoDB table layout and access patterns
  • Teams moving from MySQL, PostgreSQL, SQL Server or Oracle to DynamoDB
  • Architects estimating DynamoDB capacity and monthly cost

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install dynamodb-mcp-server

Claude Code

  1. 1

    Copy this prompt.

    Add the dynamodb-mcp-server server to Claude Code. Run this command:
    
    claude mcp add dynamodb -- uvx awslabs.dynamodb-mcp-server
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires uv (Python).

Built from the package data we hold. Not yet tested by us.

Tools

  • Guides you through designing a DynamoDB data model

    Loads an expert prompt that walks you through your access patterns and then designs tables and indexes. It saves a requirements file and a data model file in your project.

    Try: “Design a data model for my e-commerce app using the DynamoDB MCP server.”

    Files · dynamodb_data_modeling

  • Studies an existing database to plan a move to DynamoDB

    Analyzes a MySQL, PostgreSQL, SQL Server or Oracle database for its schema and query patterns, and writes analysis files. In self-service mode you run the SQL yourself. Managed mode, for MySQL only, connects through the RDS Data API or a host.

    Try: “Analyze my MySQL database and help me design a DynamoDB data model.”

    Files · source_db_analyzer

  • Tests your data model on a local DynamoDB

    Starts DynamoDB Local with Docker, Podman, Finch, nerdctl or Java, creates your tables with sample data, runs every access pattern and saves the results.

    Try: “Validate my DynamoDB data model.”

    Runs code · dynamodb_data_model_validation

  • Estimates capacity and monthly cost

    Works out read and write capacity and monthly cost from your access patterns, including extra writes for indexes and storage. It appends the report to your data model file.

    Try: “Calculate the cost and performance for my DynamoDB data model.”

    Write · compute_performances_and_costs

  • Turns your data model into a schema.json file

    Converts the data model document into a structured schema file and checks it, retrying up to 8 times.

    Try: “Convert my data model to schema.json for code generation.”

    Write · dynamodb_data_model_schema_converter

  • Checks a schema.json file

    Validates field types, operations, index mappings and pattern IDs, and suggests fixes for errors.

    Try: “Validate my schema.json file at /path/to/schema.json.”

    Files · dynamodb_data_model_schema_validator

  • Generates Python code from your schema

    Writes Python entity and repository classes with validation and the access patterns you defined, and optional usage examples. The code uses Pydantic and boto3.

    Try: “Generate Python code from my schema.json.”

    Write · generate_data_access_layer

  • Generates a CDK app that creates your tables

    Writes a CDK app that would create the tables and indexes in your data model file. It generates the files and does not deploy them.

    Try: “Generate the resources to deploy my DynamoDB data model using CDK.”

    Write · generate_resources

Read from the source code

Permissions

medium risk · 3 things to watch

Medium risk

The assistant can write design, schema and code files in your project folder and start a local test database. Run it in a scratch folder and point the database analyzer at a non-production database.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It writes files into your project folder

    It saves model, schema, analysis and generated code files. Run it in a clean folder and review the files before you use them. github.com

  • Validation starts a local database

    The validation tool launches DynamoDB Local through a container tool or Java. Allow this only on a machine where that is fine. github.com

  • Analyze a non-production database

    The README advises running the database analyzer against a non-production instance. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNot documented. The tools write files to your project folder; run it in a scratch directory if that matters.
Talks toYour source database through the RDS Data API or a host you give (managed MySQL analysis only)
Sign-in and keysUses your AWS credentials (AWS_PROFILE, AWS_REGION) only for managed MySQL analysis. Database credentials stay in AWS Secrets Manager and the server reads them from there.
Scopes
  • Local project files

  • Optional: RDS Data API and Secrets Manager access for MySQL analysis

Questions

Can it read or edit the data in my DynamoDB tables?

No. None of the eight tools lists, reads or edits tables in your AWS account. It designs models, validates them against a local test database and generates files.

Does it need AWS credentials?

Only for managed MySQL analysis, which uses the RDS Data API or a host together with Secrets Manager. Modeling, validation, cost estimates and code generation run locally.

What do I need for the validation tool?

A running container tool (Docker, Podman, Finch or nerdctl) or Java 17 or newer. The server uses DynamoDB Local for the test.

Will it deploy tables for me?

No. It generates a CDK app, and you deploy that yourself.

Which databases can it analyze?

MySQL or Aurora MySQL, PostgreSQL, SQL Server and Oracle. Self-service mode works for all four. Managed mode, which connects for you, is MySQL only.

Which AI models work best?

The README says best results come from reasoning-capable models such as Claude Sonnet 4 or 4.5, OpenAI o3 and Gemini 2.5.

Information

updated Nov 2, 2026

Publisher
Amazon Web Services (official)
Package
awslabs.dynamodb-mcp-server
Registry
PyPI
Transport
stdio
License
Apache-2.0
Last commit
Oct 30, 2026
Open issues
143
Listed in
Docker MCP Catalog

GitHubDockerDocker MCP Catalog

Other AWS MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. DynamoDB MCP Server README · github.com
  2. DynamoDB server source · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.