This MCP server lets you interact with your AWS Amplify Gen2 data through natural language. You can view schema information, run queries, and modify data using conversational prompts, while authentication ensures you access only what you’re allowed to see.

How to use

Interact with your Amplify data from an MCP client by directing requests to the Amplify Data API MCP server. You can ask questions about models, fields, and relationships, run GraphQL queries to retrieve data, and perform mutations to create, update, or delete records. Use everyday language and the MCP client will translate your prompts into the appropriate data operations.

How to install

Prerequisites You need Node.js v16 or higher and an AWS Amplify Gen2 app with data models. You also need access to your Amplify outputs file amplify_outputs.json and Cognito authentication configured in your Amplify app. Ensure you have a user with permissions suitable for admin operations.

Step by step commands You'll run these commands in a terminal.

1. Clone the MCP server repository

git clone https://github.com/dbsmith7491/aws-amplify-data-mcp.git cd aws-amplify-data-mcp

2. Install dependencies

npm install

3. Build the project

npm run build

These steps prepare the MCP server to connect to your Amplify app and expose an interface for natural language interactions.

Configuration and usage notes

Configure your Claude Desktop to run the MCP server locally. You will create or edit a configuration file to point Claude to the local node process that runs the MCP server and provide authentication details.

{
  "mcpServers": {
    "amplify-data-api": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/aws-amplify-data-mcp/build/index.js",
        "--amplify-outputs",
        "/ABSOLUTE/PATH/TO/YOUR/amplify_outputs.json"
      ],
      "env": {
        "AMPLIFY_USERNAME": "your-admin-username",
        "AMPLIFY_PASSWORD": "your-admin-password"
      }
    }
  }
}

Security and permissions

This MCP server uses Cognito authentication. Your Amplify project must be configured to use Cognito-based authentication. Create an ADMINS user group and assign appropriate users to it, then grant the group permissions to perform all operations on your models.

Troubleshooting

Authentication issues: verify Cognito credentials and user pool settings. Missing models: ensure your amplify_outputs.json is up to date. Connection problems: review Claude Desktop logs for errors. Permissions issues: confirm your user belongs to the ADMINS group or has explicit access to the models appearing in your app.

Notes for developers

TypeScript source lives under src/ and the compiled JavaScript is emitted to build/. After changing source code, run npm run build to produce updated artifacts.

Available tools

List data models

List all available data models in your Amplify app.

Get model details

Show detailed information about a specific model's fields and relationships.

Run GraphQL queries and mutations

Execute custom GraphQL queries and mutations to list, get, create, update, or delete records.

Get relationship details

Show relationships between models for understanding complex data structures.

List enums

Show all enum types defined in your data models.

Manual login

Authenticate manually if automatic authentication fails.