PlugWiki
aws-appsync-mcp-server logo

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

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

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.

Install aws-appsync-mcp-server

Claude Code

  1. 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. 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_api

  • Creates 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_api

  • Adds 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_schema

  • Connects 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_datasource

  • Connects 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_resolver

  • Creates 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_function

  • Creates 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_key

  • Turns 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_cache

  • Sets 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_name

  • Adds 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

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-onlyWrites are off by default. Add --allow-write to the server arguments to turn them on.
Talks toAWS AppSync API in your AWS account and region
Sign-in and keysUses 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

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 1
  1. aws-appsync MCP server README · github.com

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