
AWS AppSync MCP Server: Setup for Claude, Cursor and Other Apps
Lets your assistant create AWS AppSync GraphQL APIs, schemas, data sources and resolvers in your AWS account.
This is the AWS Labs server for AWS AppSync. It runs on your computer and uses your AWS profile to create APIs, schemas, data sources, resolvers, functions, API keys and caches.
Every one of its 10 tools creates something, so they all refuse to run until you add the --allow-write option to the server arguments. Use it with an AWS profile that can only reach a sandbox account while you try it.
Good for
- Backend developers who want Claude to scaffold a GraphQL API on AppSync
- Teams that connect AppSync to DynamoDB, Lambda or RDS and want the setup done from chat
- Cloud engineers who want a fast way to stand up a test API
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 aws-appsync-mcp-server
Claude Code
- 1
Copy this prompt.
Add the aws-appsync-mcp-server server to Claude Code. Run this command: claude mcp add aws-appsync -- uvx awslabs.aws-appsync-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
Creates a GraphQL API in AppSync
Sets up a new GraphQL API with the name and sign-in method you choose.
Try: “Create a GraphQL API called orders-api that uses API key sign-in.”
Write ·
create_graphql_apiCreates a new AppSync API
Creates an AppSync API from a name, with optional owner contact, tags and event configuration. Use create_graphql_api for a GraphQL API.
Try: “Create an AppSync API named live-updates.”
Write ·
create_apiAdds a GraphQL schema to an API
Uploads a GraphQL schema to an existing API and waits until AppSync finishes processing it.
Try: “Add this schema to the orders-api API and tell me when it is ready.”
Write ·
create_schemaConnects an API to a data source
Creates a data source that links the API to a service such as DynamoDB, Lambda or RDS.
Try: “Connect orders-api to my DynamoDB table named orders.”
Write ·
create_datasourceConnects a GraphQL field to a data source
Creates a resolver that tells AppSync how to fetch or save data for one field in your schema.
Try: “Add a resolver for Query.getOrder that reads from the orders data source.”
Write ·
create_resolverCreates a reusable AppSync function
Creates a function that resolvers can chain together for multi-step logic.
Try: “Create a function that checks a user's role before a mutation runs.”
Write ·
create_functionCreates an API key for an API
Creates a key that clients can use to call the API.
Try: “Make an API key for orders-api.”
Write ·
create_api_keyTurns on caching for an API
Creates a cache for the GraphQL API to speed up repeated requests.
Try: “Add a small cache to orders-api.”
Write ·
create_api_cacheSets up a custom domain for AppSync
Creates a custom domain name you can attach to your AppSync APIs.
Try: “Create a custom domain api.example.com for AppSync using my certificate.”
Write ·
create_domain_nameAdds a channel namespace for real-time events
Creates a channel namespace on an API so clients can publish and subscribe to real-time events.
Try: “Add a channel namespace called chat to live-updates.”
Write ·
create_channel_namespace
Read from the source code
Permissions
low risk · 3 things to watch
Low risk
By default the server blocks all 10 tools because each one creates AWS resources, and with the write option on it can add APIs, keys and domains to your account.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Needs --allow-write, which lets it create AWS resources
All 10 tools create something and fail without the flag. Turn it on only with an AWS profile limited to a test account.
It can create API keys and public domains
A key lets anyone who holds it call the API. Check what the assistant created in the AppSync console before sharing anything.
It has no delete or list tools
You cannot clean up through the assistant, so remove test resources in the AWS console.
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Writes are off by default. Add --allow-write to the server arguments to turn them on. |
|---|---|
| Talks to | AWS AppSync API in your AWS account and region |
| Sign-in and keys | Uses your AWS profile or access keys from your computer. Nothing is stored by the server. |
Questions
Why do the tools fail when I first try them?
Every tool creates AWS resources, and the server blocks them until you add the --allow-write option to its arguments. Add it to the server config, then restart your app.
Does it need an AWS account?
Yes. It signs in with your AWS profile or access keys and your IAM user needs AppSync permissions. Set the AWS region too.
Can it read or list my existing APIs?
No. The tools only create things, and the README lists no read or list tools.
Is it safe to run on a production account?
Not without care. With writes on, it can create APIs, keys and domains. Use a limited profile or a test account.
Does it run on my computer or in the cloud?
It runs on your computer and calls the AWS AppSync API from there.
Which apps can use it?
Any app that runs local servers, such as Claude Code, Claude Desktop, Cursor and VS Code. The install box shows the setup for each.
Information
updated Nov 2, 2026
- Publisher
- Amazon Web Services (official)
- Package
awslabs.aws-appsync-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 1Hide
- aws-appsync MCP server README · github.com