# Yaw Labs AWS MCP

> Yaw Labs AWS MCP is an open-source MCP server for cloud and infrastructure. AWS API access for AI assistants through your own CLI profiles, with in-chat SSO re-login. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://yaw.sh/mcp-servers/aws-mcp/
- **Repository:** https://github.com/yawlabs/aws-mcp
- **MCP Registry name:** io.github.YawLabs/aws-mcp
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-14

## About

Rather than a script sandbox, this server calls AWS one operation at a time through your local AWS CLI v2 and its profiles. aws_call takes a service, operation and params, so a client's approval prompt shows the actual operation. Its standout trick is SSO recovery: when a token has expired, the agent starts a device-code login, shows a URL and short code, waits for you to click, then carries on with the original question, using aws_login_start and aws_login_complete. aws_whoami reports account, ARN and token expiry countdown.

The README says it covers generic create, read, update and delete over more than 1,300 resource types through Cloud Control, with dry-run diffs that simulate a JSON Patch against current state without sending it to AWS. It also does multi-region and multi-account fan-out where partial failure is treated as normal, pre-flight IAM permission checks, live AWS documentation search and a JavaScript scripting tool for batched jobs, which is in-process and not a security sandbox. Session defaults for profile and region can be set once.

The README presents it as an alternative to AWS's own official MCP server, not something to run alongside it, and notes AWS Labs' per-service servers pair with either. It needs AWS CLI v2 (v1 is unsupported), uses AWS_PROFILE and AWS_REGION, installs from npm, is MIT licensed and is built by Yaw Labs.

## Features

- **In-chat SSO re-login:** Starts a device-code login when a token expires and resumes the task after you click.
- **One operation per call:** aws_call takes service, operation and params so approvals show the real action.
- **Cloud Control CRUD:** Generic create, read, update and delete over 1,300+ resource types with dry-run diffs.
- **Multi-region fan-out:** Runs one question across regions or accounts and returns per-region results.
- **Permission pre-checks:** Checks IAM permissions before attempting a change.
- **Docs lookup and scripting:** Searches AWS docs and offers a JavaScript tool for batched workflows.

## Good for

- Count objects in an S3 bucket even when the SSO token has expired
- Switch between prod and a region for the rest of a session
- Find every Lambda function above a memory threshold in one round trip
- Preview a resource change before applying it

## Install

### Claude Code (Terminal)

```sh
claude mcp add aws-mcp -- npx -y @yawlabs/aws-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "aws-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aws-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "aws-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "aws-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aws-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}
```

## Tools

- `aws_whoami`: Show account, ARN and SSO token expiry countdown.
- `aws_login_start`: Start the device-code SSO login flow.
- `aws_login_complete`: Finish the device-code SSO login.
- `aws_refresh_if_expiring_soon`: Proactively refresh a token that is about to expire.
- `aws_call`: Call one AWS operation by service, operation and params.
- `aws_assume_role`: Assume a role and write the resulting profile.

## FAQ

### What do I need installed?

AWS CLI v2 on your PATH and a profile for SSO or IAM Identity Center; v1 is unsupported.

### Should I run it with AWS's official MCP server?

The README advises picking one, since both call any AWS API and would give the model two redundant tools.

### How does it handle expired SSO?

It starts a device-code login, shows a URL and code, waits for you, then answers the original question.

### What is the default region?

us-east-1 unless AWS_REGION or AWS_DEFAULT_REGION is set.

### Is Yaw Labs AWS MCP free?

Yes. Yaw Labs AWS MCP is open source, so you can use and self-host it for free.

### How do I add Yaw Labs AWS MCP to Claude Code?

Run this command in your terminal: claude mcp add aws-mcp -- npx -y @yawlabs/aws-mcp

### What are the best alternatives to Yaw Labs AWS MCP?

The closest alternatives to Yaw Labs AWS MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/yaw-labs-aws-mcp
