AWS Amplify Data
About
Bridges AI systems with AWS Amplify Data APIs, enabling GraphQL-based data model interaction without requiring complex query writing
Details
- Author
- dbsmith7491
- Repository
- dbsmith7491/aws-amplify-data-mcp
- GitHub stars
- 1
- Categories
- AI, Design, Developer Tools, Search, Security, Infrastructure, API
- Tags
- #visualization
Jump to
- 💬 Natural Language Interface: Ask questions and give instructions in plain English
- 🔍 View Schema Information: List models, view field details, and explore relationships
- 📊 Query Data: Run custom GraphQL queries to list and retrieve your data
- ✏️ Modify Data: Create, update, and delete records through GraphQL mutations
- 🔐 Secure Authentication: Uses Cognito authentication with environment variables
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AWS Amplify DataCommand (node, npx, python, etc.)nodeArguments-
Argument 1
/ABSOLUTE/PATH/TO/aws-amplify-data-mcp/build/index.js -
Argument 2
--amplify-outputs -
Argument 3
/ABSOLUTE/PATH/TO/YOUR/amplify_outputs.json
Environment-
AMPLIFY_PASSWORD
your-admin-password -
AMPLIFY_USERNAME
your-admin-username
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
This MCP server uses Cognito authentication to access your Amplify data. Your Amplify project must be configured to use Cognito-based authentication. The server will only have access to data models and records that the authenticated user has permission to access.
For optimal functionality, we strongly recommend:
1. Creating an ADMINS user group in your Cognito user pool
2. Adding appropriate users to this group
3. Configuring your Amplify models with permissions that allow the ADMINS group to perform all operations
Example model authorization for admin access:
```javascript
// In your Amplify model definition
List all data models
Lists all available data models in your Amplify app.
Get model details
Shows detailed information about a specific model's fields and relationships.
Run GraphQL queries and mutations
Execute custom GraphQL queries and mutations for maximum flexibility. Handles all data operations (list, get, create, update, delete).
Get relationship details
Shows relationships between models for complex data structures.
List enums
Shows all enum types available in your data models.
Manual login
Authenticate manually if automatic authentication fails.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"aws amplify data": {
"env": {
"AMPLIFY_PASSWORD": "your-admin-password",
"AMPLIFY_USERNAME": "your-admin-username"
},
"args": [
"/ABSOLUTE/PATH/TO/aws-amplify-data-mcp/build/index.js",
"--amplify-outputs",
"/ABSOLUTE/PATH/TO/YOUR/amplify_outputs.json"
],
"command": "node"
}
}
}Linux
{
"env": {
"AMPLIFY_PASSWORD": "your-admin-password",
"AMPLIFY_USERNAME": "your-admin-username"
},
"args": [
"/ABSOLUTE/PATH/TO/aws-amplify-data-mcp/build/index.js",
"--amplify-outputs",
"/ABSOLUTE/PATH/TO/YOUR/amplify_outputs.json"
],
"command": "node"
}Macos
{
"env": {
"AMPLIFY_PASSWORD": "your-admin-password",
"AMPLIFY_USERNAME": "your-admin-username"
},
"args": [
"/ABSOLUTE/PATH/TO/aws-amplify-data-mcp/build/index.js",
"--amplify-outputs",
"/ABSOLUTE/PATH/TO/YOUR/amplify_outputs.json"
],
"command": "node"
}Windows
{
"env": {
"AMPLIFY_PASSWORD": "your-admin-password",
"AMPLIFY_USERNAME": "your-admin-username"
},
"args": [
"/c",
"node",
"/ABSOLUTE/PATH/TO/aws-amplify-data-mcp/build/index.js",
"--amplify-outputs",
"/ABSOLUTE/PATH/TO/YOUR/amplify_outputs.json"
],
"command": "cmd"
}Amplify Data API MCP Server
This MCP (Model Context Protocol) server lets you interact with your AWS Amplify Gen2 application's data through natural language. It allows AI assistants like Claude to perform operations on your Amplify data models using conversational language instead of complex code or commands.
Features
- 💬 Natural Language Interface: Ask questions and give instructions in plain English
- 🔍 View Schema Information: List models, view field details, and explore relationships
- 📊 Query Data: Run custom GraphQL queries to list and retrieve your data
- ✏️ Modify Data: Create, update, and delete records through GraphQL mutations
- 🔐 Secure Authentication: Uses Cognito authentication with environment variables
Important Authentication Requirements
This MCP server uses Cognito authentication to access your Amplify data. Your Amplify project must be configured to use Cognito-based authentication. The server will only have access to data models and records that the authenticated user has permission to access.
For optimal functionality, we strongly recommend:
1. Creating an ADMINS user group in your Cognito user pool
2. Adding appropriate users to this group
3. Configuring your Amplify models with permissions that allow the ADMINS group to perform all operations
Example model authorization for admin access:
```javascript
// In your Amplify model definition
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
