# Yaw Labs AWS MCP

A local MCP server routing AWS operations through your installed CLI, handling SSO device authentication and Cloud Control resources.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: YawLabs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/YawLabs/aws-mcp
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/yaw-labs-aws-mcp

## What it does

This server runs on your machine via `npx` without remote intermediaries. It wraps your local `aws` CLI binary directly through the `aws_call` tool, passing target operations and flags. New cloud capabilities become usable immediately whenever you upgrade your system command-line client.

Standard resource lifecycle actions go through AWS Cloud Control API. Seven `aws_resource_*` tools let the assistant inspect or modify over 1,300 CloudFormation resource types. It also provides `aws_resource_diff` for dry-run inspections. When AWS SSO credentials expire, the process initiates a device-code login flow. You get a direct link and verification code instead of dropped browser handoffs.

Running this server alongside the official AWS MCP package causes tool collisions. Pick one or the other. The local environment requires an existing `aws` CLI installation with configured profiles. Large responses hit a 5 MB boundary, so trim wide queries using JMESPath expressions.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `AWS_PROFILE`, `AWS_REGION` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: AWS

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env AWS_PROFILE=<AWS_PROFILE> --env AWS_REGION=<AWS_REGION> --transport stdio yaw-labs-aws-mcp -- npx -y @yawlabs/aws-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add yaw-labs-aws-mcp --env AWS_PROFILE=<AWS_PROFILE> --env AWS_REGION=<AWS_REGION> -- npx -y @yawlabs/aws-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yaw-labs-aws-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@yawlabs/aws-mcp"
            ],
            "env": {
                "AWS_PROFILE": "<AWS_PROFILE>",
                "AWS_REGION": "<AWS_REGION>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yaw-labs-aws-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@yawlabs/aws-mcp"
            ],
            "env": {
                "AWS_PROFILE": "<AWS_PROFILE>",
                "AWS_REGION": "<AWS_REGION>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e AWS_PROFILE=<AWS_PROFILE> -e AWS_REGION=<AWS_REGION> yaw-labs-aws-mcp npx -y @yawlabs/aws-mcp
```
Replace <…> with your own values

## When to use it
- Execute AWS CLI calls directly from an assistant session
- Authenticate with AWS SSO using device codes when browser redirects fail
- Preview CloudFormation resource changes before applying updates
- Query multiple AWS regions in parallel via `aws_multi_region`

## Example prompts
- Check our current AWS SSO session and refresh it if needed
- Fetch active S3 buckets with `aws_call` in region `eu-central-1`
- Run `aws_resource_diff` against the target SQS queue before modifying properties

## Similar
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191
- [firebase-mcp](https://affpapa.org/en/nevibecode/mcp/firebase-mcp.md) — MCP server · ★ 4482
- [Radar Kubernetes MCP Server](https://affpapa.org/en/nevibecode/mcp/radar-kubernetes-mcp-server.md) — MCP server · ★ 3918
- [Supabase](https://affpapa.org/en/nevibecode/mcp/supabase.md) — MCP server · ★ 2974
- [Microsoft Fabric MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-fabric-mcp-server.md) — MCP server · ★ 3804

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md