AWS MCP Setup Guide
Detects, selects, and configures AWS MCP servers — full API access or auth-free docs search — with built-in troubleshooting.
Dev & CodingIntermediate★ 350⑂ 40AI score 9/10Last updated: Jun 15, 2026
What it does
- Checks whether AWS MCP is already wired up via
/mcp,claude mcp list, and the.mcp.json/~/.claude.jsonconfig hierarchy. - Uses
which uvxandaws sts get-caller-identityto pick between the Full AWS MCP Server (API calls + docs) and the AWS Documentation MCP (docs only, no auth). - Supplies ready-to-paste
mcpServersJSON, three credential strategies (profile, env vars, IAM role), and the minimal IAM policy. - Verifies expected tool names after setup and provides a troubleshooting table for
uvx: command not found,AccessDenied, andInvalidSignatureException.
Who it's for
- Developers and DevOps engineers who want Claude Code to search AWS docs and call AWS APIs.
- Team leads standardizing a shared project-level
.mcp.json. - Beginners with no Python toolchain who still want AWS documentation lookup.
Examples
- "Set up AWS MCP for me" → environment probe, then the matching config block.
- "My MCP tools aren't showing up" → walks the local→project→user precedence and restart requirement.
- "I'm getting AccessDenied" → returns the IAM policy with the required aws-mcp actions.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/zxkane/aws-skills/HEAD/plugins/aws-common/skills/aws-mcp-setup/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the plugins/aws-common/skills/aws-mcp-setup folder from the GitHub repo zxkane/aws-skills into my ~/.claude/skills/aws-mcp-setup/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/zxkane/aws-skills.git /tmp/aws-skills && mkdir -p ~/.claude/skills && cp -r /tmp/aws-skills/plugins/aws-common/skills/aws-mcp-setup ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/zxkane/aws-skills.git /tmp/aws-skills - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r /tmp/aws-skills/plugins/aws-common/skills/aws-mcp-setup ~/.claude/skills/ - Restart Claude Code and ask it to "configure AWS MCP".
- (Optional) For the full server, install uv with
pip install uvand confirm credentials withaws sts get-caller-identity.
View source on GitHub ↗License: MIT