
AWS DynamoDB MCP Server: Setup for Claude, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install dynamodb-mcp-server
Claude Code
- 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
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_modelingStudies 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_analyzerTests 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_validationEstimates 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_costsTurns 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_converterChecks 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_validatorGenerates 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_layerGenerates 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-only | Not documented. The tools write files to your project folder; run it in a scratch directory if that matters. |
|---|---|
| Talks to | Your source database through the RDS Data API or a host you give (managed MySQL analysis only) |
| Sign-in and keys | Uses 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 |
|
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
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 2Hide
- DynamoDB MCP Server README · github.com
- DynamoDB server source · github.com